Cliente de Snowflake para Mac
Entre da forma exigida pela sua conta, alterne a sessão entre warehouses e funções sem reconectar e depois consulte, edite e exporte tabelas para um stage.
Funciona em MacO driver é baixado na primeira vez que você escolhe Snowflake
Visão geral
- Linguagem de consulta
- SQL
- Driver
- Baixado no primeiro uso
- Conectar por
- API do serviço
- iPhone e iPad
- Não abre
Conecte-se e entre
Informe o identificador da conta, como myorg-myaccount ou um localizador antigo como xy12345.us-east-1: o que precede .snowflakecomputing.com. Todas as requisições usam HTTPS para o endpoint da conta, portanto não há host, seção SSL ou painel SSH.
Escolha um Auth Method, e o formulário mostra apenas o necessário. Um par de chaves assina cada conexão com sua chave privada PKCS#8, portanto o relógio do Mac precisa estar correto. Browser SSO direciona você ao provedor de identidade. Um token OAuth é usado como colado e nunca renovado. Uma senha é acompanhada de um código atual em MFA Passcode (TOTP) quando a conta exige MFA.
Com ALLOW_CLIENT_MFA_CACHING na conta, um código novo é suficiente: Snowflake retorna um token MFA que TablePro guarda no Chaves. Com ALLOW_ID_TOKEN, Browser SSO guarda ali um token de login, e as próximas conexões dispensam o navegador até Snowflake recusá-lo.
Snowflake não tem um esquema de URL. Informe o nome de uma seção em CLI Connection Name, e cada campo deixado vazio será lido de ~/.snowflake/connections.toml ao conectar.
Warehouses, funções e consultas
Database > Session Context muda a sessão para outro warehouse ou função com USE WAREHOUSE e USE ROLE, sem reconectar. Uma conexão TablePro é uma sessão Snowflake, mantida aberta durante a inatividade, e uma aba vinculada a um segundo banco executa USE DATABASE antes das instruções nessa mesma sessão.
A barra lateral agrupa os objetos por banco e esquema. As listas de objetos vêm de comandos SHOW, que funcionam sem warehouse; os detalhes das colunas vêm de INFORMATION_SCHEMA, que exige um. Explain retorna o plano de Snowflake como texto bruto.
As edições na grade vinculam os valores no servidor, com células VARIANT, OBJECT e ARRAY enviadas por PARSE_JSON. Uma edição usa a chave primária declarada ou todas as colunas quando não há chave. Snowflake nunca impõe restrições de chave, portanto um valor de chave duplicado faz uma edição ou exclusão atingir todas as linhas correspondentes: verifique se há duplicatas antes de editar uma tabela.
Estrutura
A visualização DDL vem de GET_DDL. A aba Structure adiciona, renomeia e remove colunas, define NOT NULL, comentários e a chave primária, aumenta o tamanho de um VARCHAR e altera a precisão de NUMBER mantendo a escala.
Alterações que Snowflake rejeitaria são recusadas antes de qualquer execução: reduzir o tamanho de um VARCHAR, qualquer outra alteração de tipo e definir um novo valor padrão para uma coluna. Remover um valor padrão funciona.
Mova dados
Importe arquivos CSV, TSV, JSON, JSONL, XLSX e SQL pela conexão e exporte uma tabela ou um resultado para o Mac como CSV, JSON, SQL, XLSX, Markdown, HTML e XML.
Para exportar uma tabela sem passar pelo Mac, escolha File > Server-Side Export… e informe um stage, com ou sem @. Server-Side Export executa COPY INTO com seus próprios privilégios e grava CSV comprimido com gzip, Parquet ou JSON; a tela aguarda a conclusão, e nada é gravado no Mac.
iPhone e iPad
O app para iPhone e iPad não tem um driver de Snowflake. As conexões Snowflake sincronizadas de um Mac aparecem na lista, mas não abrem.
Limitações
- Duo funciona apenas com código. Aprovação por push não é compatível.
Perguntas sobre Snowflake
Por que a barra lateral mostra tabelas, mas não colunas?
Os detalhes das colunas vêm de INFORMATION_SCHEMA, que exige um warehouse em execução. Defina Warehouse na conexão ou em Session Context. Um banco cujos objetos não aparecem precisa de USAGE concedido à função usada na conexão.
Por que valores TIMESTAMP_LTZ aparecem em UTC?
TablePro os lê como horário UTC, marcado com Z, em vez de convertê-los para o TIMEZONE da sessão.
O login por par de chaves diz que o token JWT é inválido. O que devo verificar?
O token contém o localizador da conta e um timestamp. Confira o identificador da conta e o relógio do Mac, depois confirme que a chave pública está registrada no usuário com ALTER USER … SET RSA_PUBLIC_KEY.
Baixe TablePro
Requer macOS 13 Ventura ou posterior