Extrair dados da tarefa Snowflake

Sobre a tarefa Extrair dados do Snowflake

Snowflake é um software de nuvem de dados de terceiros usado para armazenar, manter e compartilhar dados. Você pode importar dados do Snowflake para usar em um fluxo de trabalho Qualtrics.

Integração com Snowflake

Para usar essa tarefa, você precisa criar uma integração no Snowflake e conectá-la ao Qualtrics.

Configuração em Snowflake

1. Faça login no Snowflake.
2. Na guia Planilhas, clique no sinal de mais ( + ) e selecione Planilha SQL.
3. Cole o seguinte código na planilha:
   

   
   CRIAR 
   
   SEGURANÇA INTEGRATIONQUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1TYPE = OAUTH
   
    OAUTH_CLIENT = CUSTOM
   
    OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
   
    OAUTH_REDIRECT_URI ='https://publicapist3.qualtrics.com/oauth-client-service/redirect'
   
    ENABLED = TRUE
   
    OAUTH_ISKFREITYSUE_REFRESHEN_ENUE OAUTH_ISKFREITY = REFRESHSHEN_ENUE OAUTH_ISKFREE_REFRESHEN_REFRESHEN_ENUE
   
    OAUTH_ISKFREE_REFREY

4. Substitua a linha QUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1 em negrito por um nome para a integração. Utilize apenas letras, números e sublinhados para o nome da integração.
   
   Qdica: Copie seu nome de integração, pois você precisará dele mais tarde para concluir a configuração. O Snowflake colocará cada letra em maiúscula automaticamente no nome da sua integração. Por exemplo, se eu nomear minha integração como “Qualtrics_Integration”, ela será salva como “QUALTRICS_INTEGRATION” no Snowflake. Este é o nome que devo salvar para depois.
5. Substitua o publicapist3 em negrito por informações sobre sua marca. Essas informações serão diferentes, dependendo de se você deseja configurar uma conexão individual dentro do próprio fluxo de trabalho ou uma conexão em toda a conta na guia Admin.
   • Se estiver criando uma conexão individual, substitua por seu brandID.
     Exemplo: se meu brandID for “dsx”, meu valor atualizado será https://dsx.qualtrics.com/oauth-client-service/redirect’
   • Ao criar uma conexão em toda a conta, substitua-a pelo seu datacenterID.
     Exemplo: se meu datacenterID for “iad1”, meu valor atualizado será https://iad1.qualtrics.com/oauth-client-service/redirect’
6. Clique em Executar.
7. Você receberá a mensagem “Integração ‘Nome da integração’ criada com êxito.”
   
   Qdica: Se você receber um erro de “privilégios insuficientes”, suas permissões de Snowflake deverão ser atualizadas. Consulte esta página de suporte Snowflake para obter mais informações sobre quais permissões são necessárias.
8. Na mesma planilha, insira o seguinte código:

   ​​​​DESCRIBE SECURITY INTEGRATION NAME_OF_SECURITY_INTEGRATION

9. Substitua a INTEGRAÇÃO em negrito NAME_OF_SECURITY_INTEGRATION pelo seu nome de integração em negrito da etapa 4.
10. Clique em Executar.
11. Você receberá várias informações sobre a integração. Copie os valores para os seguintes campos:
    
    • OAUTH_AUTHORIZATION_ENDPOINT
    • OAUTH_TOKEN_ENDPOINT
    • OAUTH_CLIENT_ID
12. Na mesma planilha, insira o seguinte código:

    SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS(‘NAME_OF_SECURITY_INTEGRATION’)

13. Substitua o NAME_OF_SECURITY_INTEGRATION em negrito pelo seu nome de integração em negrito da etapa 4.
14. Clique em Executar.
15. Copie um dos valores da chave secreta do cliente.

Configuração no Qualtrics

1. Ao criar uma conexão de toda a marca (ou seja, uma conta Snowflake disponível para todos os usuários em sua licença Qualtrics), navegue até o Extensões seção do Administrador e procure a integração Extrair dados do Snowflake.
2. Ao criar uma conexão individual (ou seja, uma conta Snowflake disponível apenas para você), navegue até Fluxos de trabalho e criar um novo fluxo de trabalho ETL. Ao selecionar sua tarefa de extrator, selecione a tarefa Extrair dados de Snowflake.
3. Clique em Adicionar conta se, na guia Admin, ou Adicionar uma conta de usuário se estiver na tarefa de fluxo de trabalho. Os passos restantes são os mesmos, independentemente de onde você está configurando sua conta.
   
4. Nomeie sua conta para identificá-la mais tarde.
   
5. Escolha Código de autorização para o Tipo de concessão.
6. Insira seus detalhes de autorização:
   • ID do cliente: o OAUTH_CLIENT_ID que você copiou na etapa 10 da Configuração no Snowflake.
   • Chave secreta do cliente: o CLIENT_SECRET que você copiou na etapa 14 da Configuração no Snowflake.
   • Ponto de acesso de token: o OAUTH_TOKEN_ENDPOINT copiado na etapa 10 da Configuração no Snowflake.
   • Ponto de acesso de autorização: o OAUTH_AUTHORIZATION_ENDPOINT copiado na etapa 10 da Configuração no Snowflake.
   • Escopos (opcional): você pode usar escopos para limitar o nível de acesso. Para a maioria dos casos de utilização, você pode deixar isso em branco.
7. Clique em Conectar conta.
8. Uma janela será aberta para você fazer login no Snowflake. Insira o nome de usuário e a senha do Snowflake.
9. Clique em Iniciar sessão.

Configurando uma tarefa Extrair dados de Snowflake

1. Siga as instruções vinculadas para criar um novo fluxo de trabalho ETL.
2. Para sua tarefa de workflow, escolha a tarefa Extrair dados de Snowflake.
3. Escolha a conta Snowflake que você conectou anteriormente.
   
4. Clique em Seguinte.
5. Insira as seguintes informações sobre os dados que você deseja importar do Snowflake:
   
   • Padrão de nome de arquivo: uma string de texto usada para identificar os arquivos a serem importados.
     Qdica: recomendamos incluir “Qualtrics” no início de todos os arquivos que você deseja importar. Em seguida, você pode inserir “Qualtrics” neste campo para importar todos os arquivos relevantes.
   • Diretório de captação: o diretório Snowflake que contém os arquivos.
     Qdica: Se o arquivo estiver na fase de base, você poderá deixar este campo em branco.
   • Identificador de conta: o identificador de conta Snowflake do banco de dados que contém os arquivos a serem importados.
   • Identificador de banco de dados: o identificador de banco de dados Snowflake do banco de dados que contém os arquivos a serem importados.
   • Identificador de esquema: o identificador de esquema Snowflake do esquema que contém o arquivo a ser importado.
   • Nome da fase: o nome da fase Snowflake que contém os arquivos a serem importados.
6. Se desejar, ative Ignorar arquivos incorretos. Quando ativado, os arquivos corrompidos e os arquivos que não correspondem aos seus cabeçalhos são ignorados.
7. Você deve carregar um arquivo de amostra que contenha o formato geral dos dados que deseja importar para a Qualtrics. Clique em Escolher arquivo e selecione o arquivo em seu computador.
   Qdica: se necessário, você pode baixar um dos arquivos de amostra listados dentro da janela de tarefas.
8. Clique em Carregar.
9. Revise seu arquivo de amostra para garantir que tudo esteja correto.
   Qdica: Se você precisar alterar seu arquivo, clique em Voltar no canto superior esquerdo.
10. Clique em Salvar.
11. Escolha sua tarefa de carregador, que determina onde os dados são salvos. Consulte Tarefas de carregador disponíveis para obter maiores informações sobre as opções disponíveis para você.