Versão preliminar de snow dcm¶

Retorna linhas de qualquer tabela, exibição ou tabela dinâmica.

Sintaxe¶

snow dcm preview
  <identifier>
  --object <object_identifier>
  --from <from_location>
  --variable <variables>
  --limit <limit>
  --target <target>
  --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
  --decimal-precision <decimal_precision>

Argumentos¶

identifier: Identificador do projeto DCM. Exemplo: MY_DB.MY_SCHEMA.MY_PROJECT. É compatível com nomes totalmente qualificados (recomendado) ou simples. Se não for qualificado, o padrão será o banco de dados e o esquema da conexão. Opcional se --target ou default_target estiver definido no manifesto.

Opções¶

--object TEXT: FQN da tabela/exibição/tabela dinâmica a ser visualizada.
--from PATH: Caminho do diretório local contendo arquivos de projeto DCM. Omita para usar o diretório atual.
--variable, -D TEXT: Variáveis para o contexto de execução; por exemplo: -D "<key>=<value>".
--limit INTEGER: O número máximo de linhas a serem retornadas.
--target TEXT: Perfil de destino do manifest.yml a ser utilizado. Usa default_target se não for especificado.
--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: sem valor. False.
--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.
--decimal-precision INTEGER: Número de casas decimais a serem exibidas para valores decimais. Usa a precisão padrão do Python se nada for especificado. [variável de ambiente: SNOWFLAKE_DECIMAL_PRECISION].

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

Notas de uso¶

O comando snow dcm preview retorna linhas de qualquer tabela, exibição ou tabela dinâmica definida no objeto de DCM project. Esse comando é útil para:

Testar suas definições antes da implantação
Verificar os dados após a implantação
Visualizar as exibições que fazem referência a nomes de tabelas modelados

Nota

Esse comando carrega automaticamente os arquivos SQL de origem locais para uma área de preparação temporária no Snowflake para que o conteúdo deles impacte o resultado final da operação.

A opção --object é obrigatória e especifica o nome totalmente qualificado do objeto de DCM project que será visualizado. Você pode usar a opção :codenowrap:` –limit` para restringir o número de linhas retornadas.

Exemplos¶

Visualizar os dados da tabela chamada MY_DB.PUBLIC.MY_TABLE de um objeto de DCM project, em que o nome do projeto está especificado na propriedade default_target no manifesto:
```
snow dcm preview --object MY_DB.PUBLIC.MY_TABLE
```
Visualizar os dados em que o nome do projeto está especificado no destino DEV no manifesto:
```
snow dcm preview --target DEV --object MY_DB.PUBLIC.MY_TABLE
```
Visualizar os dados de um objeto de DCM project com um nome totalmente qualificado explícito:
```
snow dcm preview MY_DB.MY_SCHEMA.MY_PROJECT --object MY_DB.PUBLIC.MY_TABLE
```
Visualizar com limite de linhas:
```
snow dcm preview --object MY_DB.PUBLIC.MY_VIEW --limit 10
```

Visualizar com substituição de variável:

snow dcm preview --object MY_DB.PUBLIC.MY_VIEW -D "source_table='MY_DB.PUBLIC.SOURCE'"