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

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

Neste tópico:

Instalação do conector Snowflake para ServiceNow¶

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

Entre em Snowsight como um usuário com a função ACCOUNTADMIN.
Na navegação da esquerda, selecione Marketplace.
Procure o conector do Snowflake para ServiceNow, depois selecione o bloco para o conector.
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, selecione entrar no banco de dados a ser usado como o 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.
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.
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.
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.
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.
Se você selecionar Basic authentication, insira as credenciais para sua conta ServiceNow nos campos ServiceNow username e ServiceNow password.

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:

Faça o login em sua instância do ServiceNow, depois selecione Homepage.
Procure o OAuth, depois selecione Application Registry.
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:
No ServiceNow, digite um nome para o registro do aplicativo do OAuth no campo Name.
Na UI do conector, copie o valor no campo Redirect URL.

Este valor foi gerado pelo conector.
No ServiceNow, cole este valor no campo Redirect URL.
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).
No ServiceNow, selecione Submit.

O registro do aplicativo do OAuth aparece na lista de registros do aplicativo.
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.
No ServiceNow, copie o valor para Client ID.
Cole este valor no campo Client ID na UI do conector.
No ServiceNow, copie o valor para Client Secret.
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.

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.

Na UI do conector, selecione Connect.

Uma caixa de diálogo aparece pedindo que você confirme que deseja permitir que o conector se conecte à sua conta ServiceNow.

Nota

Certifique-se de que você está conectado no ServiceNow como o mesmo usuário que você deseja que o conector use. Você pode verificar o usuário conectado no momento no canto superior direito da caixa de diálogo.
Selecione Allow.

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

Configuração do conector Snowflake para ServiceNow¶

Entre em Snowsight como um usuário com a função ACCOUNTADMIN.
Na navegação da esquerda, selecione Marketplace.
Procure o conector Snowflake para ServiceNow, depois selecione-o.

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 conector Snowflake para 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.
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.

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.

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:

Selecione Retry Setup para exibir novamente a caixa de diálogo de configuração.
Verifique se há mensagens de erro em algum dos campos.
Resolva os problemas nos campos e selecione Configure para iniciar novamente o processo de configuração.

Configuração da ingestão de dados¶

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