Floco de Neve
Snowflake
Para adicionar uma conexão de banco de dados, clique no ícone de engrenagem no canto superior direito e navegue até Configurações Admin > Bancos de Dados > Adicionar um banco de dados.
Você pode editar essas configurações a qualquer momento. Apenas lembre-se de salvar suas alterações.
Nome de exibição
O nome de exibição do banco de dados na interface do Analytics.
Conta ou hostname
Você pode usar um nome de conta ou hostname. Seu hostname é o endereço IP do seu banco de dados ou seu nome de domínio (exemplo: database.example.com).
Se sua URL inclui a região do banco de dados, você pode conectar usando um nome de conta; caso contrário, conecte usando um hostname.
AWS
Conecte usando um nome de conta.
Insira seu identificador de Conta com a região onde seu cluster Snowflake está rodando. Exemplo, xxxxxxxxx.us-east-3.aws
. Por exemplo, se você estiver usando Snowflake na AWS e sua URL da conta for https://az12345.ca-central-1.snowflakecomputing.com
:
<account_identifier>
:az12345.ca-central-1
.<cloud_platform>
:aws
.
Você deve inserir az12345.ca-central-1.aws
como nome da conta no Analytics.
Nem todas as regiões exigem o identificador da plataforma de nuvem. Se você estiver em us-west-2
, deve inserir az12345
como nome da conta. Para os requisitos por região, consulte a documentação oficial do Snowflake.
app.snowflake.com
Conecte usando um hostname.
Você pode obter seu hostname acessando Admin > Contas. O nome da Conta estará listado em Contas. Clique na conta que quer usar e clique no ícone de link para copiar a URL da conta: esse é o seu hostname. Na imagem abaixo, o Metabot está cobrindo informações sensíveis. O link “Copy account URL” à direita é o que você deve procurar:
Saiba mais sobre Identificadores de Conta no Snowflake.
Nome de usuário
O nome de usuário do banco de dados para a conta que você deseja usar para conectar ao seu banco. Você pode configurar múltiplas conexões para o mesmo banco usando diferentes usuários, cada um com diferentes conjuntos de privilégios.
Na sua conta app.snowflake.com, você pode encontrar Usuários e papéis em Admin > Usuários e Papéis.
Senha
A senha do usuário que você usa para se conectar ao banco de dados.
Chave privada RSA (PEM)
Não é obrigatório. Você pode optar por usar um Caminho de arquivo local ou um Caminho de arquivo enviado. Se você estiver na Analytics Cloud, precisará selecionar Caminho de arquivo enviado e fazer o upload do seu certificado.
Warehouse
Warehouse do Snowflake. Se o usuário não tiver um warehouse padrão, será necessário informar o warehouse para conectar.
No app.snowflake.com, você pode encontrar warehouses em Admin > Warehouses.
Nome do banco de dados (diferencia maiúsculas e minúsculas)
O nome do banco de dados que deseja conectar no Snowflake. No app.snowflake.com, você pode encontrar os bancos em Dados > Bancos de Dados.
Schemas (opcional)
Você pode especificar quais schemas deseja sincronizar e escanear. Se nenhum schema for informado, todos os schemas disponíveis para aquele usuário e papel serão listados como pastas no Analytics.
Opções de schema incluem:
- Todos
- Apenas estes...
- Todos exceto...
Para as opções Apenas estes e Todos exceto, você pode inserir uma lista separada por vírgulas para informar ao Analytics quais schemas incluir (ou excluir). Por exemplo:
FOO,BAR,BAZ
Você pode usar o caractere curinga *
para combinar múltiplos schemas.
Suponha que você tenha três schemas: FOO, BAR e BAZ.
- Se você escolher Apenas estes... e digitar
B*
, serão sincronizados BAR e BAZ. - Se você escolher Todos exceto... e digitar
B*
, será sincronizado apenas FOO.
Note que apenas o curinga *
é suportado; não é possível usar outros caracteres especiais ou expressões regulares.
Role (opcional)
ATENÇÃO: O Analytics obtém todas as permissões combinadas de todos os papéis que você conceder ao usuário no Snowflake. Configurar o ‘Role’ aqui apenas adiciona o papel na string de conexão para dizer ao Snowflake qual papel usar como padrão – isso não restringe o acesso por si só. Portanto, tenha cuidado com os papéis que você atribui ao usuário de conexão: se posteriormente conceder papéis mais amplos a esse usuário no Snowflake, o Analytics automaticamente terá essas novas permissões, podendo exibir dados que você não queria. Se desejar que o Analytics emita comandos
SET ROLE
antes de consultar qualquer coisa, veja impersonação da conexão.
Especifique um papel para substituir o papel padrão do usuário no banco. Por exemplo, se o usuário de banco ANALYTICS
tem os papéis:
- Papel padrão
APPLICATION
. - Papel adicional
ANALYTICS
.
Você pode inserir ANALYTICS
no campo Role para garantir que o usuário ANALYTICS
conecte ao Snowflake usando o papel ANALYTICS
por padrão.
Usar um túnel SSH
Veja nosso guia de tunelamento SSH.
Opções adicionais na string de conexão JDBC
Alguns bancos de dados permitem que você adicione opções ao final da string de conexão que o Analytics usa para se conectar ao banco.
Reexecutar consultas para explorações simples
Desative esta opção se as pessoas desejarem clicar em Run (botão play) antes de aplicar qualquer sumarização ou filtro.
Por padrão, o Analytics executa a consulta assim que você escolhe uma opção de agrupamento no menu Summarize ou uma condição de filtro no menu drill-through. Se seu banco for lento, você pode desativar essa reexecução automática para evitar carregamento de dados a cada clique.
Escolher quando sincronizações e varreduras acontecem
Veja sincronizações e varreduras.
Refingerprint periódico das tabelas
O refingerprint periódico aumenta a carga no seu banco de dados.
Ative esta opção para escanear uma amostra dos valores a cada vez que o Analytics executar uma sincronização.
Uma consulta de fingerprint analisa as primeiras 10.000 linhas de cada coluna e usa esses dados para estimar quantos valores únicos cada coluna tem, os valores mínimos e máximos para colunas numéricas e de timestamp, e assim por diante. Se deixar esta opção desativada, o Analytics fará o fingerprint das colunas uma única vez durante a configuração.
Recursos de modelo
Não há (ainda) recursos de modelo disponíveis para Snowflake.
Zona de perigo
Veja Zona de perigo.
Leituras adicionais
Leia a documentação para outras versões do Analytics.