Gerenciamento, atualização e desinstalação do Snowflake Connector for ServiceNow®V2¶

Pausando e retomando o Snowflake Connector for ServiceNow®V2¶

As seções a seguir descrevem como pausar e retomar o conector.

CALL PAUSE_CONNECTOR();

CALL RESUME_CONNECTOR();

Mudança do warehouse utilizado pelo conector¶

Se você quiser mudar o warehouse usado pelo conector ou adicionar um warehouse dedicado, faça isso chamando:

CALL UPDATE_WAREHOUSE('<warehouse_name>');

Copy

Onde:

warehouse_name

Especifica o nome do warehouse que o conector deve usar.

Exclusão de tabelas¶

Para excluir uma tabela (por exemplo, ativada involuntariamente) e não exibi-la nas exibições para monitoramento do conector, utilize o seguinte procedimento:

CALL DELETE_TABLE('<table_name>');

Copy

Onde:

table_name

Especifica o nome da tabela a ser excluída. Esta tabela deve estar desativada e não em processo de recarregamento.

USE ROLE ACCOUNTADMIN;
GRANT OWNERSHIP ON TABLE <destination_database>.<destination_schema>.<table_name> TO ROLE <account_role> REVOKE CURRENT GRANTS;
USE ROLE <account_role>;
DROP TABLE <destination_database>.<destination_schema>.<table_name>;

Como atualizar o token de atualização usado pelo conector¶

Se você configurar o conector com autenticação OAuth, você deve atualizar o token de atualização regularmente. Caso contrário, quando o token expirar, o conector não poderá mais acessar o ServiceNow®. Por padrão, o token expira 90 dias após sua geração.

Se você configurar alertas de e-mail para o conector, você receberá um lembrete para atualizar o token de atualização no primeiro dia de cada mês. Se o token expirar, você receberá um e-mail assim que o conector encontrar problemas para acessar o ServiceNow®.

Atualização da senha do ServiceNow® para autenticação básica¶

Para atualizar a senha, você precisa encontrar um segredo existente e modificá-lo usando o comando ALTER SECRET.

1. Determine o nome totalmente qualificado do objeto secreto usando o comando Snowsight ou SQL.

   1. Para obter um segredo usando Snowsight, faça o seguinte:

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

      2. No painel de navegação à esquerda, selecione Data Products » Apps.

      3. Procure o Snowflake Connector for ServiceNow, depois selecione o bloco para o conector.

      4. No menu de navegação superior, selecione Settings » Authentication.

         A seção Authentication mostra o objeto secreto, por exemplo: CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD.SECRET.

   2. Para obter o nome totalmente qualificado do objeto secreto usando um comando SQL, consulte a exibição CONNECTOR_CONFIGURATION:

      SELECT value FROM connector_configuration WHERE config_key = 'secret';
      

      Copy

2. Pause o conector.

3. Atualize o objeto do segredo executando o comando ALTER SECRET, alterando o parâmetro PASSWORD.

4. Retome o conector.

   A senha agora é atualizada e usada pelo conector.

Atualização da conexão com a instância do ServiceNow®¶

É possível atualizar a conexão com a instância do ServiceNow®. Permite alterar a integração de acesso externo e o segredo usado pelo conector. Também permite corrigir o problema quando o segredo foi separado da UDF de acesso externo no conector.

A configuração de conexão pode ser atualizada com o seguinte procedimento:

CALL UPDATE_CONNECTION_CONFIGURATION({
  'service_now_url': '<servicenow_base_url>',
  'secret': '<secret_name>',
  'external_access_integration': '<external_access_integration_name>'
});

Onde:

servicenow_base_url

Especifica o URL da instância do ServiceNow® que o conector deve usar. O URL deve ser definido como o mesmo durante a instalação do conector e deve estar no seguinte formato:

https://<servicenow_instance_name>.service-now.com

Copy

A alteração do URL da instância do ServiceNow® não é compatível.

secret_name

Especifica o nome totalmente qualificado do objeto segredo com as credenciais para autenticação no ServiceNow®.

Você deve especificar o nome totalmente qualificado do objeto secreto no seguinte formato:

<database_name>.<schema_name>.<secret_name>

Copy

Os nomes do banco de dados, do esquema e do segredo devem ser identificadores de objeto válidos.

external_access_integration_name

Especifica o nome da integração de acesso externo para ServiceNow®.

O nome da integração deve ser um identificador de objeto válido.

Por exemplo, para atualizar a conexão com uma instância do ServiceNow® que:

• Tenha o URL https://myinstance.service-now.com.

• Utilize o segredo armazenado em secretsdb.apiauth.servicenow_creds_oauth_code.

• Utiliza a integração de acesso externo nomeada servicenow_external_access_integration.

Execute o seguinte comando:

CALL UPDATE_CONNECTION_CONFIGURATION({
  'service_now_url': 'https://myinstance.service-now.com',
  'secret': 'SECRETSDB.APIAUTH.SERVICENOW_CREDS_OAUTH_CODE',
  'external_access_integration': 'SERVICENOW_API_INTEGRATION'
});

A atualização da configuração pode ser realizada somente por um usuário com uma concessão para a função de aplicativo ADMIN. Além disso, para executar o procedimento, o conector precisa estar no estado paused. Consulte como pausar o conector.

Exportação do estado do conector¶

É possível exportar um instantâneo do estado e da configuração atuais do conector. O instantâneo com o estado do conector exportado é útil ao reinstalar o conector para preservar tabelas já habilitadas e o estado de ingestão, ou quando a replicação do esquema de destino para a região de failover é configurada para auxiliar na recuperação de desastres.

O estado pode ser exportado com o seguinte procedimento:

CALL EXPORT_CONNECTOR_STATE();

Copy

O procedimento cria uma nova tabela __CONNECTOR_STATE_EXPORT no esquema de destino com um estado exportado. Para realizar uma exportação, as seguintes condições devem ser atendidas:

• A exportação só pode ser realizada por um usuário com uma concessão para a função de aplicativo ADMIN.

• Não há nenhuma recarga de tabela em andamento.

A configuração também é exportada automaticamente sempre que o conector aciona a ingestão de acordo com o cronograma configurado, desde que sejam cumpridas as seguintes condições:

• Pelo menos uma tabela está habilitada para ingestão.

• Não há nenhuma recarga de tabela em andamento.

Desinstalação do aplicativo¶

Esta seção explica como desinstalar o aplicativo com o Snowsight e com planilhas e como remover os objetos criados pelo conector, mas que precisam ser removidos intencionalmente pelo usuário.

Atualização do conector¶

O conector é atualizado automaticamente, o que significa que o usuário não precisa realizar nenhuma ação para ter um aplicativo atualizado.

Escalonamento do conector¶

Se houver muitas tabelas do ServiceNow® a serem ingeridas e você deseja aumentar o número de tabelas ingeridas simultaneamente, você pode alterar o parâmetro:

CALL CONFIGURE_CONCURRENCY(<number>);

Copy

Onde:

number

Especifica o número máximo de trabalhadores capazes de ingerir tabelas simultaneamente. Por padrão, esse valor é definido como 10.

O aumento da simultaneidade deve ser considerado em conjunto com a alteração do tamanho do warehouse usado para ingestão de dados. Se você estiver enfrentando alguma lentidão, tente redimensionar o warehouse. Consulte Como trabalhar com warehouses para obter mais informações.

Reinstalação do conector com o mesmo banco de dados e esquema dos dados do ServiceNow®¶

Para reinstalar o conector, siga o processo abaixo:

1. Consulte a exibição TABLES_STATE e verifique se nenhuma das tabelas está atualmente no status RELOADING:

   SELECT TABLE_NAME FROM TABLES_STATE WHERE STATUS = 'RELOADING';
   

   Copy

2. Se alguma tabela estiver sendo recarregada, aguarde a conclusão das recargas ou cancele-as.

3. Pare o conector chamando o seguinte procedimento armazenado:

   CALL PAUSE_CONNECTOR();
   

   Copy

4. Exporte estado e a configuração do conector. Consulte esta seção para mais detalhes.

   Importante

   É recomendável exportar o estado e a configuração de um conector antes de descartar o aplicativo do conector. Isso permitirá a preservação de todas as opções personalizadas (por exemplo, tabelas habilitadas para sincronização e seus cronogramas) e do estado com suas alterações mais recentes na nova instalação.

   Se você já removeu o conector, mas deixou o banco de dados e esquema com os dados ingeridos intactos, ainda poderá reinstalar o conector contando com o estado exportado automaticamente, mas o conector reinstalado poderá repetir a ingestão de alguns registros.

5. Remova o conector, transferindo a propriedade de tabelas e visualizações no esquema de destino.

6. Reinstale o conector:

   • reinstalando o conector usando o Snowsight (preferido).

   • reinstalando o conector usando SQL.

Durante o processo de instalação:

• Fornecer o banco de dados e o esquema utilizados anteriormente.

  Após a instalação, o conector detectará que o banco de dados e esquema contêm dados ingeridos e continuará a ingestão do local em que estava antes da reinstalação. Se você exportou o estado do conector e ele foi importado com sucesso durante a instalação, as tabelas ingeridas anteriormente serão ativadas automaticamente com os mesmos cronogramas e configurações. Caso contrário, você terá que habilitar manualmente todas as tabelas e, por exemplo, configurar seus cronogramas para restaurar a ingestão.

  Ao reinstalar com comandos SQL, lembre-se de transferir a propriedade de exibições e tabelas no esquema de destino para o conector, conforme descrito no guia de instalação de SQL. Caso contrário, o conector não terá acesso a essas tabelas e exibições, impedindo-o de retomar a ingestão.

• Fornecer o mesmo nome da instância do ServiceNow®.

• Para os outros argumentos, você pode reutilizar os objetos que você criou ao instalar o conector, ou você pode usar novos objetos.