@sqlanvil/cli 1.6.0 → 1.7.0

package/bundle.js

@@ -147,6 +147,7 @@ const sqlanvil = $root.sqlanvil = (() => {
          * @property {boolean|null} [includeTestsInCompiledGraph] WorkflowSettings includeTestsInCompiledGraph
          * @property {string|null} [warehouse] WorkflowSettings warehouse
          * @property {Object.<string,sqlanvil.IConnectionConfig>|null} [connections] WorkflowSettings connections
+         * @property {Object.<string,sqlanvil.IEnvironment>|null} [environments] WorkflowSettings environments
          */
 
         /**
@@ -160,6 +161,7 @@ const sqlanvil = $root.sqlanvil = (() => {
         function WorkflowSettings(properties) {
             this.vars = {};
             this.connections = {};
+            this.environments = {};
             if (properties)
                 for (let keys = Object.keys(properties), i = 0; i < keys.length; ++i)
                     if (properties[keys[i]] != null)
@@ -310,6 +312,14 @@ const sqlanvil = $root.sqlanvil = (() => {
          */
         WorkflowSettings.prototype.connections = $util.emptyObject;
 
+        /**
+         * WorkflowSettings environments.
+         * @member {Object.<string,sqlanvil.IEnvironment>} environments
+         * @memberof sqlanvil.WorkflowSettings
+         * @instance
+         */
+        WorkflowSettings.prototype.environments = $util.emptyObject;
+
         /**
          * Creates a new WorkflowSettings instance using the specified properties.
          * @function create
@@ -374,6 +384,11 @@ const sqlanvil = $root.sqlanvil = (() => {
                     writer.uint32(/* id 18, wireType 2 =*/146).fork().uint32(/* id 1, wireType 2 =*/10).string(keys[i]);
                     $root.sqlanvil.ConnectionConfig.encode(message.connections[keys[i]], writer.uint32(/* id 2, wireType 2 =*/18).fork()).ldelim().ldelim();
                 }
+            if (message.environments != null && Object.hasOwnProperty.call(message, "environments"))
+                for (let keys = Object.keys(message.environments), i = 0; i < keys.length; ++i) {
+                    writer.uint32(/* id 19, wireType 2 =*/154).fork().uint32(/* id 1, wireType 2 =*/10).string(keys[i]);
+                    $root.sqlanvil.Environment.encode(message.environments[keys[i]], writer.uint32(/* id 2, wireType 2 =*/18).fork()).ldelim().ldelim();
+                }
             return writer;
         };
 
@@ -520,6 +535,29 @@ const sqlanvil = $root.sqlanvil = (() => {
                         message.connections[key] = value;
                         break;
                     }
+                case 19: {
+                        if (message.environments === $util.emptyObject)
+                            message.environments = {};
+                        let end2 = reader.uint32() + reader.pos;
+                        key = "";
+                        value = null;
+                        while (reader.pos < end2) {
+                            let tag2 = reader.uint32();
+                            switch (tag2 >>> 3) {
+                            case 1:
+                                key = reader.string();
+                                break;
+                            case 2:
+                                value = $root.sqlanvil.Environment.decode(reader, reader.uint32());
+                                break;
+                            default:
+                                reader.skipType(tag2 & 7);
+                                break;
+                            }
+                        }
+                        message.environments[key] = value;
+                        break;
+                    }
                 default:
                     reader.skipType(tag & 7);
                     break;
@@ -627,6 +665,16 @@ const sqlanvil = $root.sqlanvil = (() => {
                         return "connections." + error;
                 }
             }
+            if (message.environments != null && message.hasOwnProperty("environments")) {
+                if (!$util.isObject(message.environments))
+                    return "environments: object expected";
+                let key = Object.keys(message.environments);
+                for (let i = 0; i < key.length; ++i) {
+                    let error = $root.sqlanvil.Environment.verify(message.environments[key[i]]);
+                    if (error)
+                        return "environments." + error;
+                }
+            }
             return null;
         };
 
@@ -700,6 +748,16 @@ const sqlanvil = $root.sqlanvil = (() => {
                     message.connections[keys[i]] = $root.sqlanvil.ConnectionConfig.fromObject(object.connections[keys[i]]);
                 }
             }
+            if (object.environments) {
+                if (typeof object.environments !== "object")
+                    throw TypeError(".sqlanvil.WorkflowSettings.environments: object expected");
+                message.environments = {};
+                for (let keys = Object.keys(object.environments), i = 0; i < keys.length; ++i) {
+                    if (typeof object.environments[keys[i]] !== "object")
+                        throw TypeError(".sqlanvil.WorkflowSettings.environments: object expected");
+                    message.environments[keys[i]] = $root.sqlanvil.Environment.fromObject(object.environments[keys[i]]);
+                }
+            }
             return message;
         };
 
@@ -719,6 +777,7 @@ const sqlanvil = $root.sqlanvil = (() => {
             if (options.objects || options.defaults) {
                 object.vars = {};
                 object.connections = {};
+                object.environments = {};
             }
             if (options.defaults) {
                 object.sqlanvilCoreVersion = "";
@@ -781,6 +840,11 @@ const sqlanvil = $root.sqlanvil = (() => {
                 for (let j = 0; j < keys2.length; ++j)
                     object.connections[keys2[j]] = $root.sqlanvil.ConnectionConfig.toObject(message.connections[keys2[j]], options);
             }
+            if (message.environments && (keys2 = Object.keys(message.environments)).length) {
+                object.environments = {};
+                for (let j = 0; j < keys2.length; ++j)
+                    object.environments[keys2[j]] = $root.sqlanvil.Environment.toObject(message.environments[keys2[j]], options);
+            }
             return object;
         };
 
@@ -813,6 +877,340 @@ const sqlanvil = $root.sqlanvil = (() => {
         return WorkflowSettings;
     })();
 
+    sqlanvil.Environment = (function() {
+
+        /**
+         * Properties of an Environment.
+         * @memberof sqlanvil
+         * @interface IEnvironment
+         * @property {string|null} [schemaSuffix] Environment schemaSuffix
+         * @property {Object.<string,string>|null} [vars] Environment vars
+         * @property {string|null} [defaultDatabase] Environment defaultDatabase
+         * @property {string|null} [defaultLocation] Environment defaultLocation
+         * @property {string|null} [credentials] Environment credentials
+         */
+
+        /**
+         * Constructs a new Environment.
+         * @memberof sqlanvil
+         * @classdesc Represents an Environment.
+         * @implements IEnvironment
+         * @constructor
+         * @param {sqlanvil.IEnvironment=} [properties] Properties to set
+         */
+        function Environment(properties) {
+            this.vars = {};
+            if (properties)
+                for (let keys = Object.keys(properties), i = 0; i < keys.length; ++i)
+                    if (properties[keys[i]] != null)
+                        this[keys[i]] = properties[keys[i]];
+        }
+
+        /**
+         * Environment schemaSuffix.
+         * @member {string} schemaSuffix
+         * @memberof sqlanvil.Environment
+         * @instance
+         */
+        Environment.prototype.schemaSuffix = "";
+
+        /**
+         * Environment vars.
+         * @member {Object.<string,string>} vars
+         * @memberof sqlanvil.Environment
+         * @instance
+         */
+        Environment.prototype.vars = $util.emptyObject;
+
+        /**
+         * Environment defaultDatabase.
+         * @member {string} defaultDatabase
+         * @memberof sqlanvil.Environment
+         * @instance
+         */
+        Environment.prototype.defaultDatabase = "";
+
+        /**
+         * Environment defaultLocation.
+         * @member {string} defaultLocation
+         * @memberof sqlanvil.Environment
+         * @instance
+         */
+        Environment.prototype.defaultLocation = "";
+
+        /**
+         * Environment credentials.
+         * @member {string} credentials
+         * @memberof sqlanvil.Environment
+         * @instance
+         */
+        Environment.prototype.credentials = "";
+
+        /**
+         * Creates a new Environment instance using the specified properties.
+         * @function create
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {sqlanvil.IEnvironment=} [properties] Properties to set
+         * @returns {sqlanvil.Environment} Environment instance
+         */
+        Environment.create = function create(properties) {
+            return new Environment(properties);
+        };
+
+        /**
+         * Encodes the specified Environment message. Does not implicitly {@link sqlanvil.Environment.verify|verify} messages.
+         * @function encode
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {sqlanvil.IEnvironment} message Environment message or plain object to encode
+         * @param {$protobuf.Writer} [writer] Writer to encode to
+         * @returns {$protobuf.Writer} Writer
+         */
+        Environment.encode = function encode(message, writer) {
+            if (!writer)
+                writer = $Writer.create();
+            if (message.schemaSuffix != null && Object.hasOwnProperty.call(message, "schemaSuffix"))
+                writer.uint32(/* id 1, wireType 2 =*/10).string(message.schemaSuffix);
+            if (message.vars != null && Object.hasOwnProperty.call(message, "vars"))
+                for (let keys = Object.keys(message.vars), i = 0; i < keys.length; ++i)
+                    writer.uint32(/* id 2, wireType 2 =*/18).fork().uint32(/* id 1, wireType 2 =*/10).string(keys[i]).uint32(/* id 2, wireType 2 =*/18).string(message.vars[keys[i]]).ldelim();
+            if (message.defaultDatabase != null && Object.hasOwnProperty.call(message, "defaultDatabase"))
+                writer.uint32(/* id 3, wireType 2 =*/26).string(message.defaultDatabase);
+            if (message.defaultLocation != null && Object.hasOwnProperty.call(message, "defaultLocation"))
+                writer.uint32(/* id 4, wireType 2 =*/34).string(message.defaultLocation);
+            if (message.credentials != null && Object.hasOwnProperty.call(message, "credentials"))
+                writer.uint32(/* id 5, wireType 2 =*/42).string(message.credentials);
+            return writer;
+        };
+
+        /**
+         * Encodes the specified Environment message, length delimited. Does not implicitly {@link sqlanvil.Environment.verify|verify} messages.
+         * @function encodeDelimited
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {sqlanvil.IEnvironment} message Environment message or plain object to encode
+         * @param {$protobuf.Writer} [writer] Writer to encode to
+         * @returns {$protobuf.Writer} Writer
+         */
+        Environment.encodeDelimited = function encodeDelimited(message, writer) {
+            return this.encode(message, writer).ldelim();
+        };
+
+        /**
+         * Decodes an Environment message from the specified reader or buffer.
+         * @function decode
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {$protobuf.Reader|Uint8Array} reader Reader or buffer to decode from
+         * @param {number} [length] Message length if known beforehand
+         * @returns {sqlanvil.Environment} Environment
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        Environment.decode = function decode(reader, length, error) {
+            if (!(reader instanceof $Reader))
+                reader = $Reader.create(reader);
+            let end = length === undefined ? reader.len : reader.pos + length, message = new $root.sqlanvil.Environment(), key, value;
+            while (reader.pos < end) {
+                let tag = reader.uint32();
+                if (tag === error)
+                    break;
+                switch (tag >>> 3) {
+                case 1: {
+                        message.schemaSuffix = reader.string();
+                        break;
+                    }
+                case 2: {
+                        if (message.vars === $util.emptyObject)
+                            message.vars = {};
+                        let end2 = reader.uint32() + reader.pos;
+                        key = "";
+                        value = "";
+                        while (reader.pos < end2) {
+                            let tag2 = reader.uint32();
+                            switch (tag2 >>> 3) {
+                            case 1:
+                                key = reader.string();
+                                break;
+                            case 2:
+                                value = reader.string();
+                                break;
+                            default:
+                                reader.skipType(tag2 & 7);
+                                break;
+                            }
+                        }
+                        message.vars[key] = value;
+                        break;
+                    }
+                case 3: {
+                        message.defaultDatabase = reader.string();
+                        break;
+                    }
+                case 4: {
+                        message.defaultLocation = reader.string();
+                        break;
+                    }
+                case 5: {
+                        message.credentials = reader.string();
+                        break;
+                    }
+                default:
+                    reader.skipType(tag & 7);
+                    break;
+                }
+            }
+            return message;
+        };
+
+        /**
+         * Decodes an Environment message from the specified reader or buffer, length delimited.
+         * @function decodeDelimited
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {$protobuf.Reader|Uint8Array} reader Reader or buffer to decode from
+         * @returns {sqlanvil.Environment} Environment
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        Environment.decodeDelimited = function decodeDelimited(reader) {
+            if (!(reader instanceof $Reader))
+                reader = new $Reader(reader);
+            return this.decode(reader, reader.uint32());
+        };
+
+        /**
+         * Verifies an Environment message.
+         * @function verify
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {Object.<string,*>} message Plain object to verify
+         * @returns {string|null} `null` if valid, otherwise the reason why it is not
+         */
+        Environment.verify = function verify(message) {
+            if (typeof message !== "object" || message === null)
+                return "object expected";
+            if (message.schemaSuffix != null && message.hasOwnProperty("schemaSuffix"))
+                if (!$util.isString(message.schemaSuffix))
+                    return "schemaSuffix: string expected";
+            if (message.vars != null && message.hasOwnProperty("vars")) {
+                if (!$util.isObject(message.vars))
+                    return "vars: object expected";
+                let key = Object.keys(message.vars);
+                for (let i = 0; i < key.length; ++i)
+                    if (!$util.isString(message.vars[key[i]]))
+                        return "vars: string{k:string} expected";
+            }
+            if (message.defaultDatabase != null && message.hasOwnProperty("defaultDatabase"))
+                if (!$util.isString(message.defaultDatabase))
+                    return "defaultDatabase: string expected";
+            if (message.defaultLocation != null && message.hasOwnProperty("defaultLocation"))
+                if (!$util.isString(message.defaultLocation))
+                    return "defaultLocation: string expected";
+            if (message.credentials != null && message.hasOwnProperty("credentials"))
+                if (!$util.isString(message.credentials))
+                    return "credentials: string expected";
+            return null;
+        };
+
+        /**
+         * Creates an Environment message from a plain object. Also converts values to their respective internal types.
+         * @function fromObject
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {Object.<string,*>} object Plain object
+         * @returns {sqlanvil.Environment} Environment
+         */
+        Environment.fromObject = function fromObject(object) {
+            if (object instanceof $root.sqlanvil.Environment)
+                return object;
+            let message = new $root.sqlanvil.Environment();
+            if (object.schemaSuffix != null)
+                message.schemaSuffix = String(object.schemaSuffix);
+            if (object.vars) {
+                if (typeof object.vars !== "object")
+                    throw TypeError(".sqlanvil.Environment.vars: object expected");
+                message.vars = {};
+                for (let keys = Object.keys(object.vars), i = 0; i < keys.length; ++i)
+                    message.vars[keys[i]] = String(object.vars[keys[i]]);
+            }
+            if (object.defaultDatabase != null)
+                message.defaultDatabase = String(object.defaultDatabase);
+            if (object.defaultLocation != null)
+                message.defaultLocation = String(object.defaultLocation);
+            if (object.credentials != null)
+                message.credentials = String(object.credentials);
+            return message;
+        };
+
+        /**
+         * Creates a plain object from an Environment message. Also converts values to other types if specified.
+         * @function toObject
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {sqlanvil.Environment} message Environment
+         * @param {$protobuf.IConversionOptions} [options] Conversion options
+         * @returns {Object.<string,*>} Plain object
+         */
+        Environment.toObject = function toObject(message, options) {
+            if (!options)
+                options = {};
+            let object = {};
+            if (options.objects || options.defaults)
+                object.vars = {};
+            if (options.defaults) {
+                object.schemaSuffix = "";
+                object.defaultDatabase = "";
+                object.defaultLocation = "";
+                object.credentials = "";
+            }
+            if (message.schemaSuffix != null && message.hasOwnProperty("schemaSuffix"))
+                object.schemaSuffix = message.schemaSuffix;
+            let keys2;
+            if (message.vars && (keys2 = Object.keys(message.vars)).length) {
+                object.vars = {};
+                for (let j = 0; j < keys2.length; ++j)
+                    object.vars[keys2[j]] = message.vars[keys2[j]];
+            }
+            if (message.defaultDatabase != null && message.hasOwnProperty("defaultDatabase"))
+                object.defaultDatabase = message.defaultDatabase;
+            if (message.defaultLocation != null && message.hasOwnProperty("defaultLocation"))
+                object.defaultLocation = message.defaultLocation;
+            if (message.credentials != null && message.hasOwnProperty("credentials"))
+                object.credentials = message.credentials;
+            return object;
+        };
+
+        /**
+         * Converts this Environment to JSON.
+         * @function toJSON
+         * @memberof sqlanvil.Environment
+         * @instance
+         * @returns {Object.<string,*>} JSON object
+         */
+        Environment.prototype.toJSON = function toJSON() {
+            return this.constructor.toObject(this, $protobuf__namespace.util.toJSONOptions);
+        };
+
+        /**
+         * Gets the default type url for Environment
+         * @function getTypeUrl
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {string} [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+         * @returns {string} The default type url
+         */
+        Environment.getTypeUrl = function getTypeUrl(typeUrlPrefix) {
+            if (typeUrlPrefix === undefined) {
+                typeUrlPrefix = "type.googleapis.com";
+            }
+            return typeUrlPrefix + "/sqlanvil.Environment";
+        };
+
+        return Environment;
+    })();
+
     sqlanvil.ConnectionConfig = (function() {
 
         /**
@@ -39801,7 +40199,7 @@ function collectEvaluationQueries(queryOrAction, concatenate, queryModifier = (q
         .filter(validationQuery => !!validationQuery.query);
 }
 
-const version = "1.6.0";
+const version = "1.7.0";
 const dataformVersion = "3.0.59";
 
 async function build(compiledGraph, runConfig, dbadapter) {
@@ -40128,6 +40526,7 @@ async function test$1(dbadapter, timeoutMs = 10000) {
 
 const gitIgnoreContents = `
 ${CREDENTIALS_FILENAME}
+.df-credentials*.json
 node_modules/
 `;
 function postgresCredentialsTemplate(warehouse) {
@@ -41003,6 +41402,46 @@ function normalizeRow(row) {
     return newRow;
 }
 
+function resolveEnvironment(projectDir, envName) {
+    const settings = readConfigFromWorkflowSettings(projectDir);
+    const environments = (settings === null || settings === void 0 ? void 0 : settings.environments) || {};
+    const env = environments[envName];
+    if (!env) {
+        const available = Object.keys(environments);
+        throw new Error(`Environment "${envName}" not found. ` +
+            (available.length
+                ? `Available environments: ${available.join(", ")}.`
+                : `No environments defined in workflow_settings.yaml.`));
+    }
+    const configOverride = {};
+    if (env.schemaSuffix) {
+        configOverride.schemaSuffix = env.schemaSuffix;
+    }
+    if (env.vars && Object.keys(env.vars).length > 0) {
+        configOverride.vars = env.vars;
+    }
+    if (env.defaultDatabase) {
+        configOverride.defaultDatabase = env.defaultDatabase;
+    }
+    if (env.defaultLocation) {
+        configOverride.defaultLocation = env.defaultLocation;
+    }
+    return { configOverride, credentials: env.credentials || undefined };
+}
+function mergeProjectConfigOverride(envOverride, cliOverride) {
+    const merged = Object.assign(Object.assign({}, envOverride), cliOverride);
+    if (envOverride.vars || cliOverride.vars) {
+        merged.vars = Object.assign(Object.assign({}, envOverride.vars), cliOverride.vars);
+    }
+    return merged;
+}
+function resolveCredentials(envCredentials, cliCredentials, defaultFilename) {
+    if (cliCredentials && cliCredentials !== defaultFilename) {
+        return cliCredentials;
+    }
+    return envCredentials || defaultFilename;
+}
+
 function parsePostgresEvalError(_query, error) {
     return sqlanvil.QueryEvaluationError.create({
         message: (error === null || error === void 0 ? void 0 : error.message) ? String(error.message) : String(error)
@@ -43632,6 +44071,21 @@ const actionRetryLimitName = "action-retry-limit";
 function getCredentialsPath(projectDir, credentialsPath) {
     return actuallyResolve(projectDir, credentialsPath);
 }
+function projectConfigOverrideWithEnvironment(projectDir, argv) {
+    const cliOverride = ProjectConfigOptions.constructProjectConfigOverride(argv);
+    if (!argv[ProjectConfigOptions.environment.name]) {
+        return cliOverride;
+    }
+    const { configOverride } = resolveEnvironment(projectDir, argv[ProjectConfigOptions.environment.name]);
+    return mergeProjectConfigOverride(configOverride, cliOverride);
+}
+function credentialsPathWithEnvironment(projectDir, argv) {
+    const envCredentials = argv[ProjectConfigOptions.environment.name]
+        ? resolveEnvironment(projectDir, argv[ProjectConfigOptions.environment.name]).credentials
+        : undefined;
+    const chosen = resolveCredentials(envCredentials, argv[credentialsOption.name], CREDENTIALS_FILENAME);
+    return getCredentialsPath(projectDir, chosen);
+}
 function runCli() {
     const builtYargs = createYargsCli({
         commands: [
@@ -43789,7 +44243,7 @@ function runCli() {
                         }
                         const compiledGraph = await compile({
                             projectDir,
-                            projectConfigOverride: ProjectConfigOptions.constructProjectConfigOverride(argv),
+                            projectConfigOverride: projectConfigOverrideWithEnvironment(projectDir, argv),
                             timeoutMillis: argv[timeoutOption.name] || undefined,
                             verbose: argv[verboseOptionName] || false
                         });
@@ -43870,7 +44324,7 @@ function runCli() {
                     }
                     const compiledGraph = await compile({
                         projectDir: argv[projectDirMustExistOption.name],
-                        projectConfigOverride: ProjectConfigOptions.constructProjectConfigOverride(argv),
+                        projectConfigOverride: projectConfigOverrideWithEnvironment(argv[projectDirMustExistOption.name], argv),
                         timeoutMillis: argv[timeoutOption.name] || undefined
                     });
                     if (compiledGraphHasErrors(compiledGraph)) {
@@ -43881,7 +44335,7 @@ function runCli() {
                         printSuccess("Compiled successfully.\n");
                     }
                     const warehouse = compiledGraph.projectConfig.warehouse || "bigquery";
-                    const readCredentials = read(getCredentialsPath(argv[projectDirOption.name], argv[credentialsOption.name]), warehouse);
+                    const readCredentials = read(credentialsPathWithEnvironment(argv[projectDirMustExistOption.name], argv), warehouse);
                     if (!compiledGraph.tests.length) {
                         printError("No unit tests found.");
                         return 1;
@@ -43953,7 +44407,7 @@ function runCli() {
                     }
                     const compiledGraph = await compile({
                         projectDir: argv[projectDirOption.name],
-                        projectConfigOverride: ProjectConfigOptions.constructProjectConfigOverride(argv),
+                        projectConfigOverride: projectConfigOverrideWithEnvironment(argv[projectDirOption.name], argv),
                         timeoutMillis: argv[timeoutOption.name] || undefined
                     });
                     if (compiledGraphHasErrors(compiledGraph)) {
@@ -43964,7 +44418,7 @@ function runCli() {
                         printSuccess("Compiled successfully.\n");
                     }
                     const warehouse = compiledGraph.projectConfig.warehouse || "bigquery";
-                    const readCredentials = read(getCredentialsPath(argv[projectDirOption.name], argv[credentialsOption.name]), warehouse);
+                    const readCredentials = read(credentialsPathWithEnvironment(argv[projectDirOption.name], argv), warehouse);
                     let dbadapter;
                     if (warehouse.toLowerCase() === "supabase") {
                         dbadapter = await SupabaseDbAdapter.create(readCredentials);
@@ -44019,7 +44473,7 @@ function runCli() {
                         print("No actions to run.\n");
                         return 0;
                     }
-                    const connectionCredentials = readConnections(getCredentialsPath(argv[projectDirOption.name], argv[credentialsOption.name]));
+                    const connectionCredentials = readConnections(credentialsPathWithEnvironment(argv[projectDirOption.name], argv));
                     assertConnectionCredentialsAvailable(executionGraph, connectionCredentials);
                     if (argv[dryRunOptionName]) {
                         print("Dry running (no changes to the warehouse will be applied)...");
@@ -44263,6 +44717,11 @@ ProjectConfigOptions.defaultReservation = option("default-reservation", {
         "workflow_settings.yaml is used. If neither is set, default BigQuery behavior applies.",
     type: "string"
 });
+ProjectConfigOptions.environment = option("environment", {
+    describe: "Named environment from workflow_settings.yaml `environments:` to load (its schemaSuffix, " +
+        "vars, defaultDatabase/location, and credentials file). Explicit flags override the environment.",
+    type: "string"
+});
 ProjectConfigOptions.allYargsOptions = [
     ProjectConfigOptions.defaultDatabase,
     ProjectConfigOptions.defaultSchema,
@@ -44273,7 +44732,8 @@ ProjectConfigOptions.allYargsOptions = [
     ProjectConfigOptions.schemaSuffix,
     ProjectConfigOptions.tablePrefix,
     ProjectConfigOptions.disableAssertions,
-    ProjectConfigOptions.defaultReservation
+    ProjectConfigOptions.defaultReservation,
+    ProjectConfigOptions.environment
 ];
 
 runCli();

package/package.json

@@ -62,7 +62,7 @@
     "bin": {
         "sqlanvil": "bundle.js"
     },
-    "version": "1.6.0",
+    "version": "1.7.0",
     "name": "@sqlanvil/cli",
     "description": "sqlanvil command line interface.",
     "main": "bundle.js"

package/worker_bundle.js

@@ -88,6 +88,7 @@ const sqlanvil = $root.sqlanvil = (() => {
          * @property {boolean|null} [includeTestsInCompiledGraph] WorkflowSettings includeTestsInCompiledGraph
          * @property {string|null} [warehouse] WorkflowSettings warehouse
          * @property {Object.<string,sqlanvil.IConnectionConfig>|null} [connections] WorkflowSettings connections
+         * @property {Object.<string,sqlanvil.IEnvironment>|null} [environments] WorkflowSettings environments
          */
 
         /**
@@ -101,6 +102,7 @@ const sqlanvil = $root.sqlanvil = (() => {
         function WorkflowSettings(properties) {
             this.vars = {};
             this.connections = {};
+            this.environments = {};
             if (properties)
                 for (let keys = Object.keys(properties), i = 0; i < keys.length; ++i)
                     if (properties[keys[i]] != null)
@@ -251,6 +253,14 @@ const sqlanvil = $root.sqlanvil = (() => {
          */
         WorkflowSettings.prototype.connections = $util.emptyObject;
 
+        /**
+         * WorkflowSettings environments.
+         * @member {Object.<string,sqlanvil.IEnvironment>} environments
+         * @memberof sqlanvil.WorkflowSettings
+         * @instance
+         */
+        WorkflowSettings.prototype.environments = $util.emptyObject;
+
         /**
          * Creates a new WorkflowSettings instance using the specified properties.
          * @function create
@@ -315,6 +325,11 @@ const sqlanvil = $root.sqlanvil = (() => {
                     writer.uint32(/* id 18, wireType 2 =*/146).fork().uint32(/* id 1, wireType 2 =*/10).string(keys[i]);
                     $root.sqlanvil.ConnectionConfig.encode(message.connections[keys[i]], writer.uint32(/* id 2, wireType 2 =*/18).fork()).ldelim().ldelim();
                 }
+            if (message.environments != null && Object.hasOwnProperty.call(message, "environments"))
+                for (let keys = Object.keys(message.environments), i = 0; i < keys.length; ++i) {
+                    writer.uint32(/* id 19, wireType 2 =*/154).fork().uint32(/* id 1, wireType 2 =*/10).string(keys[i]);
+                    $root.sqlanvil.Environment.encode(message.environments[keys[i]], writer.uint32(/* id 2, wireType 2 =*/18).fork()).ldelim().ldelim();
+                }
             return writer;
         };
 
@@ -461,6 +476,29 @@ const sqlanvil = $root.sqlanvil = (() => {
                         message.connections[key] = value;
                         break;
                     }
+                case 19: {
+                        if (message.environments === $util.emptyObject)
+                            message.environments = {};
+                        let end2 = reader.uint32() + reader.pos;
+                        key = "";
+                        value = null;
+                        while (reader.pos < end2) {
+                            let tag2 = reader.uint32();
+                            switch (tag2 >>> 3) {
+                            case 1:
+                                key = reader.string();
+                                break;
+                            case 2:
+                                value = $root.sqlanvil.Environment.decode(reader, reader.uint32());
+                                break;
+                            default:
+                                reader.skipType(tag2 & 7);
+                                break;
+                            }
+                        }
+                        message.environments[key] = value;
+                        break;
+                    }
                 default:
                     reader.skipType(tag & 7);
                     break;
@@ -568,6 +606,16 @@ const sqlanvil = $root.sqlanvil = (() => {
                         return "connections." + error;
                 }
             }
+            if (message.environments != null && message.hasOwnProperty("environments")) {
+                if (!$util.isObject(message.environments))
+                    return "environments: object expected";
+                let key = Object.keys(message.environments);
+                for (let i = 0; i < key.length; ++i) {
+                    let error = $root.sqlanvil.Environment.verify(message.environments[key[i]]);
+                    if (error)
+                        return "environments." + error;
+                }
+            }
             return null;
         };
 
@@ -641,6 +689,16 @@ const sqlanvil = $root.sqlanvil = (() => {
                     message.connections[keys[i]] = $root.sqlanvil.ConnectionConfig.fromObject(object.connections[keys[i]]);
                 }
             }
+            if (object.environments) {
+                if (typeof object.environments !== "object")
+                    throw TypeError(".sqlanvil.WorkflowSettings.environments: object expected");
+                message.environments = {};
+                for (let keys = Object.keys(object.environments), i = 0; i < keys.length; ++i) {
+                    if (typeof object.environments[keys[i]] !== "object")
+                        throw TypeError(".sqlanvil.WorkflowSettings.environments: object expected");
+                    message.environments[keys[i]] = $root.sqlanvil.Environment.fromObject(object.environments[keys[i]]);
+                }
+            }
             return message;
         };
 
@@ -660,6 +718,7 @@ const sqlanvil = $root.sqlanvil = (() => {
             if (options.objects || options.defaults) {
                 object.vars = {};
                 object.connections = {};
+                object.environments = {};
             }
             if (options.defaults) {
                 object.sqlanvilCoreVersion = "";
@@ -722,6 +781,11 @@ const sqlanvil = $root.sqlanvil = (() => {
                 for (let j = 0; j < keys2.length; ++j)
                     object.connections[keys2[j]] = $root.sqlanvil.ConnectionConfig.toObject(message.connections[keys2[j]], options);
             }
+            if (message.environments && (keys2 = Object.keys(message.environments)).length) {
+                object.environments = {};
+                for (let j = 0; j < keys2.length; ++j)
+                    object.environments[keys2[j]] = $root.sqlanvil.Environment.toObject(message.environments[keys2[j]], options);
+            }
             return object;
         };
 
@@ -754,6 +818,340 @@ const sqlanvil = $root.sqlanvil = (() => {
         return WorkflowSettings;
     })();
 
+    sqlanvil.Environment = (function() {
+
+        /**
+         * Properties of an Environment.
+         * @memberof sqlanvil
+         * @interface IEnvironment
+         * @property {string|null} [schemaSuffix] Environment schemaSuffix
+         * @property {Object.<string,string>|null} [vars] Environment vars
+         * @property {string|null} [defaultDatabase] Environment defaultDatabase
+         * @property {string|null} [defaultLocation] Environment defaultLocation
+         * @property {string|null} [credentials] Environment credentials
+         */
+
+        /**
+         * Constructs a new Environment.
+         * @memberof sqlanvil
+         * @classdesc Represents an Environment.
+         * @implements IEnvironment
+         * @constructor
+         * @param {sqlanvil.IEnvironment=} [properties] Properties to set
+         */
+        function Environment(properties) {
+            this.vars = {};
+            if (properties)
+                for (let keys = Object.keys(properties), i = 0; i < keys.length; ++i)
+                    if (properties[keys[i]] != null)
+                        this[keys[i]] = properties[keys[i]];
+        }
+
+        /**
+         * Environment schemaSuffix.
+         * @member {string} schemaSuffix
+         * @memberof sqlanvil.Environment
+         * @instance
+         */
+        Environment.prototype.schemaSuffix = "";
+
+        /**
+         * Environment vars.
+         * @member {Object.<string,string>} vars
+         * @memberof sqlanvil.Environment
+         * @instance
+         */
+        Environment.prototype.vars = $util.emptyObject;
+
+        /**
+         * Environment defaultDatabase.
+         * @member {string} defaultDatabase
+         * @memberof sqlanvil.Environment
+         * @instance
+         */
+        Environment.prototype.defaultDatabase = "";
+
+        /**
+         * Environment defaultLocation.
+         * @member {string} defaultLocation
+         * @memberof sqlanvil.Environment
+         * @instance
+         */
+        Environment.prototype.defaultLocation = "";
+
+        /**
+         * Environment credentials.
+         * @member {string} credentials
+         * @memberof sqlanvil.Environment
+         * @instance
+         */
+        Environment.prototype.credentials = "";
+
+        /**
+         * Creates a new Environment instance using the specified properties.
+         * @function create
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {sqlanvil.IEnvironment=} [properties] Properties to set
+         * @returns {sqlanvil.Environment} Environment instance
+         */
+        Environment.create = function create(properties) {
+            return new Environment(properties);
+        };
+
+        /**
+         * Encodes the specified Environment message. Does not implicitly {@link sqlanvil.Environment.verify|verify} messages.
+         * @function encode
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {sqlanvil.IEnvironment} message Environment message or plain object to encode
+         * @param {$protobuf.Writer} [writer] Writer to encode to
+         * @returns {$protobuf.Writer} Writer
+         */
+        Environment.encode = function encode(message, writer) {
+            if (!writer)
+                writer = $Writer.create();
+            if (message.schemaSuffix != null && Object.hasOwnProperty.call(message, "schemaSuffix"))
+                writer.uint32(/* id 1, wireType 2 =*/10).string(message.schemaSuffix);
+            if (message.vars != null && Object.hasOwnProperty.call(message, "vars"))
+                for (let keys = Object.keys(message.vars), i = 0; i < keys.length; ++i)
+                    writer.uint32(/* id 2, wireType 2 =*/18).fork().uint32(/* id 1, wireType 2 =*/10).string(keys[i]).uint32(/* id 2, wireType 2 =*/18).string(message.vars[keys[i]]).ldelim();
+            if (message.defaultDatabase != null && Object.hasOwnProperty.call(message, "defaultDatabase"))
+                writer.uint32(/* id 3, wireType 2 =*/26).string(message.defaultDatabase);
+            if (message.defaultLocation != null && Object.hasOwnProperty.call(message, "defaultLocation"))
+                writer.uint32(/* id 4, wireType 2 =*/34).string(message.defaultLocation);
+            if (message.credentials != null && Object.hasOwnProperty.call(message, "credentials"))
+                writer.uint32(/* id 5, wireType 2 =*/42).string(message.credentials);
+            return writer;
+        };
+
+        /**
+         * Encodes the specified Environment message, length delimited. Does not implicitly {@link sqlanvil.Environment.verify|verify} messages.
+         * @function encodeDelimited
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {sqlanvil.IEnvironment} message Environment message or plain object to encode
+         * @param {$protobuf.Writer} [writer] Writer to encode to
+         * @returns {$protobuf.Writer} Writer
+         */
+        Environment.encodeDelimited = function encodeDelimited(message, writer) {
+            return this.encode(message, writer).ldelim();
+        };
+
+        /**
+         * Decodes an Environment message from the specified reader or buffer.
+         * @function decode
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {$protobuf.Reader|Uint8Array} reader Reader or buffer to decode from
+         * @param {number} [length] Message length if known beforehand
+         * @returns {sqlanvil.Environment} Environment
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        Environment.decode = function decode(reader, length, error) {
+            if (!(reader instanceof $Reader))
+                reader = $Reader.create(reader);
+            let end = length === undefined ? reader.len : reader.pos + length, message = new $root.sqlanvil.Environment(), key, value;
+            while (reader.pos < end) {
+                let tag = reader.uint32();
+                if (tag === error)
+                    break;
+                switch (tag >>> 3) {
+                case 1: {
+                        message.schemaSuffix = reader.string();
+                        break;
+                    }
+                case 2: {
+                        if (message.vars === $util.emptyObject)
+                            message.vars = {};
+                        let end2 = reader.uint32() + reader.pos;
+                        key = "";
+                        value = "";
+                        while (reader.pos < end2) {
+                            let tag2 = reader.uint32();
+                            switch (tag2 >>> 3) {
+                            case 1:
+                                key = reader.string();
+                                break;
+                            case 2:
+                                value = reader.string();
+                                break;
+                            default:
+                                reader.skipType(tag2 & 7);
+                                break;
+                            }
+                        }
+                        message.vars[key] = value;
+                        break;
+                    }
+                case 3: {
+                        message.defaultDatabase = reader.string();
+                        break;
+                    }
+                case 4: {
+                        message.defaultLocation = reader.string();
+                        break;
+                    }
+                case 5: {
+                        message.credentials = reader.string();
+                        break;
+                    }
+                default:
+                    reader.skipType(tag & 7);
+                    break;
+                }
+            }
+            return message;
+        };
+
+        /**
+         * Decodes an Environment message from the specified reader or buffer, length delimited.
+         * @function decodeDelimited
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {$protobuf.Reader|Uint8Array} reader Reader or buffer to decode from
+         * @returns {sqlanvil.Environment} Environment
+         * @throws {Error} If the payload is not a reader or valid buffer
+         * @throws {$protobuf.util.ProtocolError} If required fields are missing
+         */
+        Environment.decodeDelimited = function decodeDelimited(reader) {
+            if (!(reader instanceof $Reader))
+                reader = new $Reader(reader);
+            return this.decode(reader, reader.uint32());
+        };
+
+        /**
+         * Verifies an Environment message.
+         * @function verify
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {Object.<string,*>} message Plain object to verify
+         * @returns {string|null} `null` if valid, otherwise the reason why it is not
+         */
+        Environment.verify = function verify(message) {
+            if (typeof message !== "object" || message === null)
+                return "object expected";
+            if (message.schemaSuffix != null && message.hasOwnProperty("schemaSuffix"))
+                if (!$util.isString(message.schemaSuffix))
+                    return "schemaSuffix: string expected";
+            if (message.vars != null && message.hasOwnProperty("vars")) {
+                if (!$util.isObject(message.vars))
+                    return "vars: object expected";
+                let key = Object.keys(message.vars);
+                for (let i = 0; i < key.length; ++i)
+                    if (!$util.isString(message.vars[key[i]]))
+                        return "vars: string{k:string} expected";
+            }
+            if (message.defaultDatabase != null && message.hasOwnProperty("defaultDatabase"))
+                if (!$util.isString(message.defaultDatabase))
+                    return "defaultDatabase: string expected";
+            if (message.defaultLocation != null && message.hasOwnProperty("defaultLocation"))
+                if (!$util.isString(message.defaultLocation))
+                    return "defaultLocation: string expected";
+            if (message.credentials != null && message.hasOwnProperty("credentials"))
+                if (!$util.isString(message.credentials))
+                    return "credentials: string expected";
+            return null;
+        };
+
+        /**
+         * Creates an Environment message from a plain object. Also converts values to their respective internal types.
+         * @function fromObject
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {Object.<string,*>} object Plain object
+         * @returns {sqlanvil.Environment} Environment
+         */
+        Environment.fromObject = function fromObject(object) {
+            if (object instanceof $root.sqlanvil.Environment)
+                return object;
+            let message = new $root.sqlanvil.Environment();
+            if (object.schemaSuffix != null)
+                message.schemaSuffix = String(object.schemaSuffix);
+            if (object.vars) {
+                if (typeof object.vars !== "object")
+                    throw TypeError(".sqlanvil.Environment.vars: object expected");
+                message.vars = {};
+                for (let keys = Object.keys(object.vars), i = 0; i < keys.length; ++i)
+                    message.vars[keys[i]] = String(object.vars[keys[i]]);
+            }
+            if (object.defaultDatabase != null)
+                message.defaultDatabase = String(object.defaultDatabase);
+            if (object.defaultLocation != null)
+                message.defaultLocation = String(object.defaultLocation);
+            if (object.credentials != null)
+                message.credentials = String(object.credentials);
+            return message;
+        };
+
+        /**
+         * Creates a plain object from an Environment message. Also converts values to other types if specified.
+         * @function toObject
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {sqlanvil.Environment} message Environment
+         * @param {$protobuf.IConversionOptions} [options] Conversion options
+         * @returns {Object.<string,*>} Plain object
+         */
+        Environment.toObject = function toObject(message, options) {
+            if (!options)
+                options = {};
+            let object = {};
+            if (options.objects || options.defaults)
+                object.vars = {};
+            if (options.defaults) {
+                object.schemaSuffix = "";
+                object.defaultDatabase = "";
+                object.defaultLocation = "";
+                object.credentials = "";
+            }
+            if (message.schemaSuffix != null && message.hasOwnProperty("schemaSuffix"))
+                object.schemaSuffix = message.schemaSuffix;
+            let keys2;
+            if (message.vars && (keys2 = Object.keys(message.vars)).length) {
+                object.vars = {};
+                for (let j = 0; j < keys2.length; ++j)
+                    object.vars[keys2[j]] = message.vars[keys2[j]];
+            }
+            if (message.defaultDatabase != null && message.hasOwnProperty("defaultDatabase"))
+                object.defaultDatabase = message.defaultDatabase;
+            if (message.defaultLocation != null && message.hasOwnProperty("defaultLocation"))
+                object.defaultLocation = message.defaultLocation;
+            if (message.credentials != null && message.hasOwnProperty("credentials"))
+                object.credentials = message.credentials;
+            return object;
+        };
+
+        /**
+         * Converts this Environment to JSON.
+         * @function toJSON
+         * @memberof sqlanvil.Environment
+         * @instance
+         * @returns {Object.<string,*>} JSON object
+         */
+        Environment.prototype.toJSON = function toJSON() {
+            return this.constructor.toObject(this, $protobuf__namespace.util.toJSONOptions);
+        };
+
+        /**
+         * Gets the default type url for Environment
+         * @function getTypeUrl
+         * @memberof sqlanvil.Environment
+         * @static
+         * @param {string} [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+         * @returns {string} The default type url
+         */
+        Environment.getTypeUrl = function getTypeUrl(typeUrlPrefix) {
+            if (typeUrlPrefix === undefined) {
+                typeUrlPrefix = "type.googleapis.com";
+            }
+            return typeUrlPrefix + "/sqlanvil.Environment";
+        };
+
+        return Environment;
+    })();
+
     sqlanvil.ConnectionConfig = (function() {
 
         /**