snow spcs service create¶

Nota

Você pode usar os Snowpark Container Services da Snowflake CLI somente se você tiver as permissões necessárias para usar o Snowpark Container Services.

Cria um novo serviço no esquema atual.

Sintaxe¶

snow spcs service create
  <name>
  --compute-pool <compute_pool>
  --spec-path <spec_path>
  --min-instances <min_instances>
  --max-instances <max_instances>
  --auto-resume / --no-auto-resume
  --eai-name <external_access_integrations>
  --query-warehouse <query_warehouse>
  --tag <tags>
  --comment <comment>
  --if-not-exists
  --connection <connection>
  --host <host>
  --port <port>
  --account <account>
  --user <user>
  --password <password>
  --authenticator <authenticator>
  --workload-identity-provider <workload_identity_provider>
  --private-key-file <private_key_file>
  --token <token>
  --token-file-path <token_file_path>
  --database <database>
  --schema <schema>
  --role <role>
  --warehouse <warehouse>
  --temporary-connection
  --mfa-passcode <mfa_passcode>
  --enable-diag
  --diag-log-path <diag_log_path>
  --diag-allowlist-path <diag_allowlist_path>
  --oauth-client-id <oauth_client_id>
  --oauth-client-secret <oauth_client_secret>
  --oauth-authorization-url <oauth_authorization_url>
  --oauth-token-request-url <oauth_token_request_url>
  --oauth-redirect-uri <oauth_redirect_uri>
  --oauth-scope <oauth_scope>
  --oauth-disable-pkce
  --oauth-enable-refresh-tokens
  --oauth-enable-single-use-refresh-tokens
  --client-store-temporary-credential
  --format <format>
  --verbose
  --debug
  --silent
  --enhanced-exit-codes

Copy

Argumentos¶

name: Identificador do serviço; por exemplo: meu_serviço.

Opções¶

--compute-pool TEXT: Pool de computação para executar o serviço.
--spec-path FILE: Caminho para o arquivo de especificação de serviço.
--min-instances INTEGER RANGE: Número mínimo de instâncias de serviço a serem executadas. Padrão: 1
--max-instances INTEGER RANGE: Número máximo de instâncias de serviço a serem executadas.
--auto-resume / --no-auto-resume: O serviço será retomado automaticamente quando uma função de serviço ou entrada for chamada. Padrão: Verdadeiro.
--eai-name TEXT: Identifica integrações de acesso externo (EAI) que o serviço pode acessar. Esta opção pode ser especificada várias vezes para várias EAIs.
--query-warehouse TEXT: Warehouse a ser usado se um contêiner de serviço se conectar ao Snowflake para executar uma consulta sem especificar explicitamente um warehouse a ser usado.
--tag NAME=VALUE: Tag do serviço.
--comment TEXT: Comentário para o serviço.
--if-not-exists: Aplique esta operação somente se o objeto especificado ainda não existir. Padrão: falso.
--connection, -c, --environment TEXT: Nome da conexão, conforme definido no arquivo config.toml. Padrão: default.
--host TEXT: Endereço do host da conexão. Substitui o valor especificado para a conexão.
--port INTEGER: Porta para a conexão. Substitui o valor especificado para a conexão.
--account, --accountname TEXT: Nome atribuído à sua conta Snowflake. Substitui o valor especificado para a conexão.
--user, --username TEXT: Nome de usuário para se conectar ao Snowflake. Substitui o valor especificado para a conexão.
--password TEXT: Senha do Snowflake. Substitui o valor especificado para a conexão.
--authenticator TEXT: Autenticador Snowflake. Substitui o valor especificado para a conexão.
--workload-identity-provider TEXT: Provedor de identidade de carga de trabalho (AWS, AZURE, GCP, OIDC). Substitui o valor especificado para a conexão.
--private-key-file, --private-key-path TEXT: Caminho do arquivo de chave privada Snowflake. Substitui o valor especificado para a conexão.
--token TEXT: Token OAuth a ser usado ao se conectar ao Snowflake.
--token-file-path TEXT: Caminho para o arquivo com um token OAuth a ser usado ao se conectar ao Snowflake.
--database, --dbname TEXT: Banco de dados a ser usado. Substitui o valor especificado para a conexão.
--schema, --schemaname TEXT: Esquema de banco de dados a ser usado. Substitui o valor especificado para a conexão.
--role, --rolename TEXT: Função a ser usada. Substitui o valor especificado para a conexão.
--warehouse TEXT: Warehouse a ser usado. Substitui o valor especificado para a conexão.
--temporary-connection, -x: Usa uma conexão definida com parâmetros de linha de comando, em vez de uma definida na configuração. Padrão: falso.
--mfa-passcode TEXT: Token a ser usado para autenticação multifator (MFA).
--enable-diag: Se deve gerar um relatório de diagnóstico de conexão. Padrão: falso.
--diag-log-path TEXT: Caminho para o relatório gerado. O padrão é o diretório temporário do sistema. Padrão: <system_temporary_directory>.
--diag-allowlist-path TEXT: Caminho para um arquivo JSON que contém parâmetros da lista de permissões.
--oauth-client-id TEXT: Valor do ID de cliente fornecido pelo provedor de identidade para integração com o Snowflake.
--oauth-client-secret TEXT: Valor do segredo do cliente fornecido pelo provedor de identidade para integração com o Snowflake.
--oauth-authorization-url TEXT: Ponto de extremidade do provedor de identidade que fornece o código de autorização ao driver.
--oauth-token-request-url TEXT: Ponto de extremidade do provedor de identidade que fornece os tokens de acesso ao driver.
--oauth-redirect-uri TEXT: URI a ser usado para redirecionamento de código de autorização.
--oauth-scope TEXT: Escopo solicitado na solicitação de autorização do provedor de identidade.
--oauth-disable-pkce: Desativa o Proof Key for Code Exchange (PKCE). Padrão: False.
--oauth-enable-refresh-tokens: Permite uma reautenticação silenciosa quando o token de acesso real fica desatualizado. Padrão: False.
--oauth-enable-single-use-refresh-tokens: Se o usuário deve optar pela semântica de token de atualização de uso único. Padrão: False.
--client-store-temporary-credential: Armazena a credencial temporária.
--format [TABLE|JSON|JSON_EXT|CSV]: Especifica o formato de saída. Padrão: TABLE.
--verbose, -v: Exibe entradas de log para os níveis de log info e superiores. Padrão: falso.
--debug: Exibe entradas de log para níveis de log de depuração e superiores; os logs de depuração contêm informações adicionais. Padrão: falso.
--silent: Desliga a saída intermediária para o console. Padrão: falso.
--enhanced-exit-codes: Diferencia os códigos de erro de saída com base no tipo de falha. Padrão: falso.

--help: Exibe o texto de ajuda para este comando.

Notas de uso¶

Opcionalmente, você pode optar por executar mais de uma instância do seu serviço. Cada instância de serviço é uma coleção de contêineres, conforme definido no arquivo de especificação de serviço, que são executados juntos em um nó no seu pool de computação. Se você optar por executar várias instâncias de um serviço, um balanceador de carga gerenciará o tráfego de entrada.

Exemplos¶

snow spcs service create "my-service" --compute-pool "pool_1" --spec-path "/some-dir/echo-speck.yaml"

Copy