Guia de conexão do Snowflake para o Jitterbit App Builder
Introdução
Este guia mostra como conectar um app do App Builder a uma conta do Snowflake usando OAuth ou autenticação baseada em certificado.
Autenticação OAuth
Pré-requisitos
- Uma conta ativa do Snowflake, configurada para OAuth.
1. Configurar um provedor de segurança
-
Selecione IDE > Security Providers.
-
Clique no botão + Security Provider.
-
Defina valores para os seguintes campos:
-
Na seção Settings:
- Name: Insira um nome para o provedor de segurança.
- Type: Selecione OAuth.
- Enabled: Selecionado.
-
Na seção Authentication:
- OAuth Grant: Selecione Authorization Code.
- OAuth Client Authentication: Selecione Basic.
- OAuth Resource Authentication: Selecione Bearer.
-
Na seção Tokens:
- Owner: Selecione User.
-
Na seção Sign In:
- Redirect On Challenge: Selecionado.
-
-
Clique no botão Save. Painéis adicionais aparecem.
-
Na seção Endpoints, clique no botão + Endpoint e adicione os seguintes endpoints:
Tipo de Endpoint URL Authorization Endpoint https://{Snowflake account URL}/oauth/authorizeToken Endpoint https://{Snowflake account URL}/oauth/token-request -
Na seção Credentials, clique no botão + Credential e adicione a seguinte credencial:
Tipo Nome de Usuário Senha Client OAUTH_CLIENT_IDOAUTH_CLIENT_SECRETNota
OAUTH_CLIENT_IDeOAUTH_CLIENT_SECRETsão saídas do comandoSYSTEM$SHOW_OAUTH_CLIENT_SECRETS. -
Na seção Properties, clique em + Property e adicione a seguinte propriedade:
Parâmetro Valor Scopes session:role:SYSADMIN
2. Configurar um servidor de dados
- Selecione IDE > Data Servers.
- Clique no botão + Server.
-
Na janela Server, defina valores para o seguinte:
-
Na seção Server Settings:
- Server Name: Insira um nome para este servidor Snowflake.
- Type: Selecione Snowflake. Campos adicionais aparecem. Defina valores para o seguinte:
- URL: A URL.
- Warehouse: O nome do seu warehouse Snowflake.
- Database Name: O nome do seu banco de dados Snowflake.
- Schema Name: O nome do seu schema Snowflake.
-
Na seção Security:
- Security Provider: Selecione o provedor de segurança OAuth criado anteriormente.
- User Name: Deixe em branco.
- Password: Deixe em branco.
-
Description: (Opcional) Insira uma descrição para este servidor de dados.
-
-
Clique no botão Save.
- Na seção Server Settings, clique no botão Advanced Settings. A janela Server (Advanced Settings) abre.
- Clique no botão Edit.
- No campo Advanced, insira
AuthScheme=OAuth. - Clique no botão Save e depois feche as janelas Server (Advanced Settings) e Server.
Agora use o servidor de dados em seus apps.
Autenticação baseada em certificado
A autenticação baseada em certificado usa um par de chaves RSA. A chave pública é registrada na conta do usuário do Snowflake e o App Builder usa o arquivo de chave privada para se autenticar.
Pré-requisitos
- Uma conta Snowflake ativa.
- Um par de chaves RSA gerado. Consulte Gerar a chave privada na documentação do Snowflake para obter instruções. O arquivo de chave privada (
.p8) deve estar no sistema de arquivos do servidor do App Builder e ser legível pelo processo do App Builder.
1. Configurar Snowflake
Execute os seguintes comandos SQL no Snowflake como um usuário com a função ACCOUNTADMIN.
-
Criar um usuário Snowflake com a chave pública atribuída:
CREATE USER {username} LOGIN_NAME = {username} DISPLAY_NAME = 'App Builder (Key Auth)' -- The public key must be a single, continuous string. -- Do not include the '-----BEGIN PUBLIC KEY-----' or '-----END PUBLIC KEY-----' header lines. RSA_PUBLIC_KEY = '{public_key_content}'; -
Conceder a função necessária ao usuário:
GRANT ROLE {role_name} TO USER {username}; -
Conceder uso no banco de dados e no esquema para a função:
GRANT USAGE ON DATABASE {database_name} TO ROLE {role_name}; GRANT USAGE ON SCHEMA {database_name}.{schema_name} TO ROLE {role_name}; -
Definir o contexto padrão para o usuário:
ALTER USER {username} SET DEFAULT_ROLE = {role_name}, DEFAULT_WAREHOUSE = '{warehouse_name}', DEFAULT_NAMESPACE = '{database_name}.{schema_name}';
2. Configurar um servidor de dados
- Selecione IDE > Servidores de Dados.
- Clique no botão + Servidor.
-
No popup Servidor, defina valores para o seguinte:
-
Na seção Configurações do Servidor:
- Nome do Servidor: Digite um nome para este servidor Snowflake.
- Tipo: Selecione Snowflake. Campos adicionais aparecem. Defina valores para o seguinte:
- URL: A URL.
- Warehouse: O nome do seu warehouse Snowflake.
- Nome do Banco de Dados: O nome do seu banco de dados Snowflake.
- Nome do Esquema: O nome do seu esquema Snowflake.
-
Na seção Segurança:
- Provedor de Segurança: Deixe em branco.
- Nome de Usuário: Digite o nome de usuário Snowflake criado na etapa 1.
- Senha: Deixe em branco.
-
Descrição: (Opcional) Digite uma descrição para este servidor de dados.
-
-
Clique no botão Salvar.
- Na seção Configurações do Servidor, clique no botão Configurações Avançadas. O popup Servidor (Configurações Avançadas) abre.
- Clique no botão Editar.
-
No campo Avançado, digite a seguinte string de conexão, substituindo
{path_to_private_key_file}pelo caminho absoluto do arquivo de chave privada.p8no servidor do App Builder:AuthScheme=PrivateKey;PrivateKeyType=PEMKEY_FILE;PrivateKey={path_to_private_key_file} -
Clique no botão Salvar, depois feche os popups Servidor (Configurações Avançadas) e Servidor.
Agora é possível usar o servidor de dados nos apps.
Solução de problemas
Se tiver problemas com o Snowflake, recomenda-se seguir estas etapas de solução de problemas:
-
Ative o registro de dados para gerar arquivos de log e dados, que você pode baixar e inspecionar.
-
Consulte a documentação do CData ADO.NET Provider para Snowflake para obter informações detalhadas.