Instalação e configuração do conector com Snowsight

O conector Snowflake para ServiceNow® está sujeito aos Termos do conector.

Este tópico fornece informações sobre como instalar e configurar o Snowflake Connector for ServiceNow® pelo Snowsight.

Neste tópico:

Instalação do Snowflake Connector for ServiceNow®

O seguinte procedimento descreve como instalar o conector:

  1. Entre em Snowsight como um usuário com a função ACCOUNTADMIN.

  2. No menu de navegação, selecione Data Products » Marketplace.

  3. Procure o conector Snowflake para ServiceNow®, depois selecione o bloco do conector.

  4. Na página do Snowflake Connector for ServiceNow®, selecione Get.

    Isto exibe uma caixa de diálogo que você utiliza para iniciar a parte inicial do processo de instalação.

    Na caixa de diálogo, configure o seguinte:

    1. No campo Database name, insira o nome do banco de dados a ser usado como banco de dados para a instância do conector. Este banco de dados é criado automaticamente para você.

    2. No campo Warehouse used for installation, selecione o warehouse que você deseja usar para a instalação do conector.

      Nota

      Este não é o mesmo warehouse que é usado pelo conector para sincronizar os dados do ServiceNow. Em uma etapa posterior, você criará um warehouse separado para este fim.

    3. No campo Which roles, in addition to ACCOUNTADMIN, can access this database?, adicione as outras funções às quais você deseja ter acesso ao banco de dados.

    4. Selecione Get.

  5. Uma caixa de diálogo aparece com a notificação: <Nome do seu banco de dados> is now ready to use in your account. Para continuar a configuração, selecione Manage.

    A caixa de diálogo se fecha e a página do Snowflake Connector for ServiceNow® exibe a UI para configurar e gerenciar o conector.

Configuração da conexão ao ServiceNow

Os seguintes procedimentos descrevem como configurar uma conexão com o ServiceNow:

  1. Na seção Connections, selecione Connect para ajustar as configurações para conexão com a instância do ServiceNow.

    Isto exibe a caixa de diálogo Connect to ServiceNow.

  2. No campo ServiceNow Instance, digite o nome da instância do ServiceNow.

    Esta é a primeira parte do nome do host de sua instância do ServiceNow. Por exemplo, se o URL para sua instância do ServiceNow for:

    https://myinstance.service-now.com
    
    Copy

    O nome de sua instância seria myinstance.

  3. No campo Authentication Method, selecione o método de autenticação que você deseja usar para permitir que o conector se conecte à instância do ServiceNow.

    Você pode selecionar a autenticação básica (nome de usuário e senha) ou OAuth.

  4. Se você selecionar Basic authentication, insira as credenciais para sua conta ServiceNow nos campos ServiceNow username e ServiceNow password.

  5. Se você selecionar OAuth, crie um registro do aplicativo no ServiceNow e use-o para configurar o conector.

    Para criar o registro do aplicativo, faça o seguinte:

    1. Faça o login em sua instância do ServiceNow, depois selecione Homepage.

    2. Procure o OAuth, depois selecione Application Registry.

    3. Selecione New, e depois selecione Create an OAuth API endpoint for external clients.

      Isto exibe uma página de configuração para o registro do aplicativo, como mostrado na imagem a seguir:

      Exibe a página Registro do aplicativo no ServiceNow à esquerda.
    4. No ServiceNow, digite um nome para o registro do aplicativo do OAuth no campo Name.

    5. Na UI do conector, copie o valor no campo Redirect URL.

      Este valor foi gerado pelo conector.

    6. No ServiceNow, cole este valor no campo Redirect URL.

    7. Se necessário, no ServiceNow, atualize os valores nos campos Refresh Token Lifespan e Access Token Lifespan.

      • Snowflake recomenda ajustar a vida útil do token de acesso para pelo menos 600 segundos.

      • Para a vida útil do token de atualização, especifique um valor que seja 7776000 (90 dias).

    8. No ServiceNow, selecione Submit.

      O registro do aplicativo do OAuth aparece na lista de registros do aplicativo.

    9. No ServiceNow, selecione o registro do aplicativo que você acabou de criar.

      Observe que o ServiceNow criou valores para os campos Client ID e Client Secret.

    10. No ServiceNow, copie o valor para Client ID.

    11. Cole este valor no campo Client ID na UI do conector.

    12. No ServiceNow, copie o valor para Client Secret.

    13. Cole este valor no campo Client Secret na UI do conector.

      O conector usa um segredo (um tipo de objeto em nível de esquema) para armazenar os tokens de acesso usados para autenticar na instância do ServiceNow. O conector usa este objeto secreto com uma integração de segurança e uma integração de API para se conectar à instância do ServiceNow.

      O segredo, a integração de segurança e a integração de API são criados automaticamente quando se instala o conector.

    14. Para especificar como o objeto secreto, a integração de segurança e a integração de API são configurados, selecione Advanced Settings e preencha os seguintes campos:

      Campo

      Descrição

      Secret Name

      O nome do segredo. O conector gera este valor. Você não pode alterar este valor.

      Authorization URL

      O URL para autenticar na instância do ServiceNow. Este URL deve estar no seguinte formato:

      https://<instance_name>.service-now.com/oauth_token.do
      
      Copy

      Onde instance_name é o nome de sua instância do ServiceNow.

      Token URL

      O URL para solicitar um token de atualização para a instância do ServiceNow. Este URL deve estar no seguinte formato:

      https://<instance_name>.service-now.com/oauth_token.do
      
      Copy

      Onde instance_name é o nome de sua instância do ServiceNow.

      Allowed Prefix

      O URL para sua instância do ServiceNow.

      Isto limita o uso destas configurações de conexão. As configurações só podem ser usadas para conectar a URLs com os prefixos especificados.

  6. Na UI do conector, selecione Connect.

    Uma caixa de diálogo aparece solicitando que você faça login na sua instância ServiceNow com nome de usuário e senha. Forneça as credenciais do usuário com o qual você deseja que o conector seja autenticado. Ele precisa ter os privilégios listados em Preparação de sua instância do ServiceNow®.

  7. Depois de entrar, confirme que deseja permitir que o conector se conecte à sua conta ServiceNow. Selecione Allow.

    Nota

    Se você foi redirecionado diretamente para esta caixa de diálogo sem precisar fornecer credenciais, você já está conectado à sua instância ServiceNow. Certifique-se de estar conectado como o mesmo usuário que o conector deve usar e de que esse usuário tenha os privilégios necessários. Nota: o usuário atualmente conectado é mostrado no canto superior direito da caixa de diálogo.

    A nova conexão do ServiceNow aparece na área Connection.

Como resultado dessas etapas, o assistente cria os seguintes objetos residentes fora do banco de dados do conector que são necessários para o funcionamento do conector:

  • Banco de dados CONNECTORS_UI com esquema SERVICENOW_GZSTZTP0KHD usado para armazenar objeto secreto,

  • Objeto secreto em CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD chamado SECRET com credenciais ServiceNow,

  • Integração de segurança chamada SERVICENOW_GZSTZTP0KHD_INTEGRATION, que é usada para integração entre o Snowflake e um serviço de OAuth 2.0 de terceiros se a autenticação OAuth tiver sido escolhida como método de autorização,

  • integração de API SERVICENOW_GZSTZTP0KHD_API é usada para comunicação com ServiceNow.

Os nomes desses objetos não podem ser alterados. O conector faz referência a eles por nome. Alterar seus nomes ou descartá-los quebrará as referências e quebrará o conector.

Configuração do Snowflake Connector for ServiceNow®

  1. Entre em Snowsight como um usuário com a função ACCOUNTADMIN.

  2. No menu de navegação, selecione Data Products » Marketplace.

  3. Procure por Snowflake Connector for ServiceNow® e, em seguida, selecione-a.

  4. Sob o status do conector, selecione Configure.

    Isto exibe a caixa de diálogo Configure Connector.

    Nota

    Por padrão, os campos são definidos como os nomes dos objetos que são criados quando você configura o conector. Snowflake recomenda o uso de novos objetos para estes campos. No entanto, você pode especificar os nomes dos objetos existentes, se necessário (por exemplo, se você estiver reinstalando o conector).

    Nesta caixa de diálogo, preencha os seguintes campos:

    Campo

    Descrição

    Warehouse

    Identificador para um novo warehouse virtual dedicado para o conector.

    Especifique um nome que seja único para sua conta. O nome do warehouse deve ser um identificador de objeto válido.

    Nota

    Não especifique o mesmo warehouse que você selecionou no início da instalação do conector.

    O processo de configuração cria um novo warehouse Large com o nome especificado.

    Destination Database

    Identificador para um novo banco de dados que conterá o esquema com as tabelas para os dados do ServiceNow no Snowflake.

    Especifique um nome que seja único para sua conta. O nome do banco de dados deve ser um identificador de objeto válido.

    O processo de configuração cria um novo banco de dados com o nome especificado.

    Destination Schema

    Identificador para um novo esquema que conterá os dados do ServiceNow no Snowflake.

    O Snowflake Connector for ServiceNow® faz a ingestão de dados do ServiceNow em tabelas neste esquema.

    Especifique um nome que seja único para sua conta. O nome do esquema deve ser um identificador de objeto válido.

    O processo de configuração cria um novo esquema com o nome especificado.

    Role

    Identificador para uma nova função personalizada para o conector. Esta função permite que o conector o faça o seguinte:

    • Crie e gerencie tarefas para ingerir os dados.

    • Use o warehouse dedicado.

    • Acesse o segredo e a integração de API a fim de conectar-se à instância do ServiceNow.

    A função também é a proprietária das tabelas e exibições que contêm os dados do ServiceNow ingeridos pelo conector.

    Especifique um nome que seja único para sua conta. O nome da função deve ser um identificador de objeto válido.

    O processo de configuração cria uma nova função com o nome especificado.

    Embora seja recomendado criar funções separadas e mais refinadas para acessar os dados ingeridos após o início da ingestão, você pode usar essa função para consultar dados ingeridos e estendê-los com privilégios adicionais. Por outro lado, a revogação de privilégios de função para objetos exigidos pelo conector ou alterações na propriedade de funções de tabelas e exibições com dados ingeridos não é permitida e interromperá o conector.

    Journal table

    (Opcional) Para permitir a propagação de registros excluídos, defina isso na tabela que serve como fonte de informação sobre os registros apagados.

    Você pode usar a tabela sys_audit_delete ou uma tabela de diário personalizada como fonte de informações sobre registros excluídos.

    Se você não quiser ingerir registros excluídos do ServiceNow para o Snowflake, deixe este campo vazio.

    Nota

    Certifique-se de que o usuário ServiceNow do conector tenha acesso à tabela de diário especificada.

  5. Selecione Configure.

A caixa de diálogo se fecha e o status do conector muda para Provisioning. O processo de configuração pode levar alguns minutos para ser concluído.

A seção Connector Objects exibe os objetos que foram criados automaticamente durante a instalação e configuração. O conector usa esses objetos para ingerir dados da instância do ServiceNow. Para visualizar os detalhes de um objeto, selecione o objeto.

Se o processo de configuração terminar com sucesso, o status exibido muda para Inactive.

O conector faz referência ao warehouse, ao banco de dados de destino, ao esquema de destino e à função por nome. Alterar os nomes desses objetos ou excluí-los fará com que as referências sejam quebradas e, como resultado, o conector será quebrado. Em vez de renomear o warehouse, use o procedimento armazenado CONFIGURE_WAREHOUSE para alterar o warehouse usado pelo conector.

Solução de problemas durante a configuração

Se ocorrer um erro durante o processo de configuração, o estado do conector muda para Incomplete. Para identificar e tratar os erros:

  1. Selecione Retry Setup para exibir novamente a caixa de diálogo de configuração.

  2. Verifique se há mensagens de erro em algum dos campos.

  3. Resolva os problemas nos campos e selecione Configure para iniciar novamente o processo de configuração.

Próximos passos

Após instalar e configurar o conector, execute as etapas descritas em Configuração da ingestão de dados para seus dados do ServiceNow®.