snow object list¶
Lista todos os objetos Snowflake disponíveis do tipo fornecido. Tipos suportados: pool-de-computação, banco de dados, integração-de-acesso-externo, função, repositório-git, repositório-imagem, integração, regra-de-rede, procedimento, função, esquema, segredo, serviço, estágio, fluxo, streamlit, tabela, tarefa, usuário, exibição, warehouse
Sintaxe¶
snow object list
<object_type>
--like <like>
--in <scope>
--connection <connection>
--host <host>
--port <port>
--account <account>
--user <user>
--password <password>
--authenticator <authenticator>
--private-key-file <private_key_file>
--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>
--format <format>
--verbose
--debug
--silent
Argumentos¶
object_type
Tipo de objeto. Por exemplo, tabela, banco de dados, pool de computação.
Opções¶
--like, -l TEXT
Padrão SQL LIKE para filtrar objetos por nome. Por exemplo,
list function --like "my%"
lista todas as funções que começam com “my”. Padrão: %%.--in <TEXT TEXT>...
Especifica o escopo deste comando usando “–in <escopo> <nome>”, por exemplo
list table --in database my_db
. Alguns tipos de objetos têm escopos especializados (por exemplo, list service –in compute-pool my_pool). Padrão: (Nenhum, Nenhum).--connection, -c, --environment TEXT
Nome da conexão, conforme definido no arquivo
config.toml
. Padrão:padrão
.--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.
--private-key-file, --private-key-path TEXT
Caminho do arquivo de chave privada Snowflake. Substitui o valor especificado para a conexão.
--token-file-path TEXT
Caminho para o arquivo com um token OAuth que deve ser usado ao conectar-se 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 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
Execução do teste de diagnóstico do conector Python. Padrão: falso.
--diag-log-path TEXT
Caminho do relatório de diagnóstico. Padrão: <temporary_directory>.
--diag-allowlist-path TEXT
Caminho do relatório de diagnóstico para a lista de permissões opcional.
--format [TABLE|JSON]
Especifica o formato de saída. Padrão: TABLE.
--verbose, -v
Exibe entradas de log para níveis de log
info
e superior. 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.
--help
Exibe o texto de ajuda para este comando.
Notas de uso¶
A opçõ --like [-l] <padrão>
permite que você especifique um SQL LIKE padrão para filtrar objetos por nome. Por exemplo, snow object list function --like "my%"
lista todas as funções que começam com my. Para mais informações sobre padrões de sintaxe SQL, consulte palavra-chave SQL LIKE.
Exemplos¶
O exemplo a seguir lista todas as funções que começam com public. A opção --like
snow object list role --like public%
show roles like 'public%'
+-------------------------------------------------------------------------------
| created_on | name | is_default | is_current | ...
|----------------------------------+-------------+------------+------------+----
| 2023-02-01 15:25:04.105000-08:00 | PUBLIC | N | N | ...
| 2024-01-15 12:55:05.840000-08:00 | PUBLIC_TEST | N | N | ...
+-------------------------------------------------------------------------------