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

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

Estas seções e suas seções descrevem as tarefas típicas que você pode precisar executar após a instalação e configuração do conector:

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.

Como atualizar o token de atualização para o conector instalado usando o Snowsight

Para atualizar o token de atualização se o conector foi instalado usando o Snowsight, faça o seguinte:

  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 Snowflake Connector for ServiceNow®, depois selecione o bloco para o conector.

  4. Em Connections, selecione o botão de reticências e depois Refresh token.

    Nota

    Certifique-se de que você entrou no ServiceNow como o mesmo usuário com o qual o conector foi inicialmente configurado. Você pode verificar o usuário conectado no momento no canto superior direito da caixa de diálogo.

  5. Para confirmar que você permite que o conector se conecte a sua conta ServiceNow, selecione Allow na caixa de diálogo.

    O token de atualização agora está atualizado.

Para saber como atualizar o token de atualização usando comandos SQL, consulte Como atualizar o token de atualização usando comandos SQL.

Como atualizar o token de atualização usando comandos SQL

Para atualizar o token de atualização usando comandos SQL, faça o seguinte:

  1. Baixe um novo token de atualização do OAuth. Certifique-se de usar o mesmo client_id, client_secret e as credenciais do usuário que o conector está usando no momento.

  2. Descubra o nome totalmente qualificado do objeto secreto consultando a exibição GLOBAL_CONFIG:

    SELECT value:secret FROM GLOBAL_CONFIG WHERE key = 'connection_config';
    Copy

  3. Atualize o objeto secreto executando os comandos ALTER SECRET, alterando os seguintes parâmetros:

    • Defina OAUTH_REFRESH_TOKEN como o token de atualização do OAuth que você recuperou na primeira etapa.

    • Defina OAUTH_REFRESH_TOKEN_EXPIRY_TIME como o carimbo de data/hora da expiração do token de atualização no fuso horário UTC. Você pode calcular isto adicionando a vida útil do token de atualização do ServiceNow até a data em que o token foi emitido. Por padrão, o token expira em 100 dias.

    Por exemplo, para atualizar o segredo secretsdb.apiauth.servicenow_creds_oauth_code, execute o seguinte comando:

    ALTER SECRET secretsdb.apiauth.servicenow_creds_oauth_code SET OAUTH_REFRESH_TOKEN = '34n;vods4nQsdg09wee4qnfvadH', OAUTH_REFRESH_TOKEN_EXPIRY_TIME = '2022-01-06 20:00:00';
    Copy

    Nota

    Para atualizar o segredo, você deve usar a função com privilégio OWNERSHIP.

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.

    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 menu de navegação, selecione Data Products » Marketplace.

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

    4. Em Connections, selecione ellipses próximo à direita do rótulo ServiceNow e selecione View details.

      A caixa de diálogo ServiceNow Connection Configuration mostra o objeto do segredo, por exemplo: CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD.SECRET.

    Para obter um segredo usando o comando SQL, consulte a exibição GLOBAL_CONFIG:

    SELECT VALUE:secret FROM GLOBAL_CONFIG WHERE KEY = 'connection_config';
    Copy

  2. Pare o conector.

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

    Por exemplo, para atualizar o segredo secretsdb.apiauth.servicenow_basic_auth, execute o seguinte comando:

    ALTER SECRET secretsdb.apiauth.servicenow_basic_auth SET PASSWORD = 'W3dr@fg*7B1c4j';
    Copy

  4. Retome o conector.

    A senha agora é atualizada e usada pelo conector.

Nota

Assim como a alteração da senha, você tem a opção de atualizar o nome de usuário usando o comando ALTER SECRET. Basta definir o parâmetro USERNAME para o novo nome de usuário. Antes de alterar o nome de usuário, certifique-se de que o novo nome de usuário tenha, no mínimo, os mesmos privilégios do anterior, caso contrário o conector poderá não funcionar corretamente.

Eliminação de objetos criados durante a instalação usando a Snowsight

A remoção do banco de dados do conector não exclui os dados ingeridos que são armazenados em um banco de dados separado ou os objetos que foram criados durante a instalação feita usando a Snowsight.

Para ver os objetos criados durante a instalação, faça o seguinte:

  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.

  4. Na página de Snowflake Connector for ServiceNow®, localize a área Connector Objects.

Para excluir esses objetos, execute o comando DROP .

Por exemplo, para excluir o segredo, execute a instrução DROP SECRET.

Desinstalação e exclusão de objetos criados durante a instalação manualmente

A remoção do banco de dados do conector não exclui os dados ingeridos que são armazenados em um banco de dados separado nem os objetos que você criou ao instalar o conector. Isso inclui:

Para excluir esses objetos, execute a instrução DROP . Por exemplo, para excluir o segredo, execute a instrução DROP SECRET.

Para excluir Snowflake Connector for ServiceNow®, use DROP DATABASE:

DROP DATABASE <database_name>;
Copy

Onde

database_name

Especifica o nome do banco de dados criado durante a instalação do conector.

Por exemplo, para excluir um conector instalado no banco de dados chamado my_connector_servicenow, execute o seguinte comando:

DROP DATABASE my_connector_servicenow;
Copy

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.

Nota

O procedimento DELETE_TABLE não remove os objetos criados para esta tabela no banco de dados e no esquema que contém os dados do ServiceNow no Snowflake (tabela de dados brutos, tabela de logs de eventos e exibições niveladas). Você pode descartar esses objetos manualmente.

Atualização do conector

Esta seção descreve como atualizar o conector de sua conta Snowflake.

Atualmente, o conector não é atualizado automaticamente. Para atualizar seu conector para a versão mais recente, chame o procedimento de nome RUN_UPGRADE:

CALL RUN_UPGRADE();
Copy

Você pode realizar esta atualização a qualquer momento (desde que ninguém mais esteja configurando o conector ao mesmo tempo).

A atualização deve ser concluída rapidamente. A atualização desativa temporariamente a ingestão dos dados do ServiceNow. Quando a atualização é concluída, o conector retoma a ingestão de dados.

Nota

Ao executar a atualização, certifique-se de que ninguém esteja configurando o conector ao mesmo tempo.

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

Se você removeu o conector mas deixou o banco de dados e o esquema contendo os dados ingeridos intactos, você pode mais tarde reinstalar o conector e retomar a ingestão de dados a partir do ponto onde o conector estava funcionando pela última vez.

Nota

Para garantir a consistência dos dados, aguarde até que a ingestão atual seja concluída e pare o conector antes de desinstalar o conector:

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

    SELECT * FROM TABLES_STATE;
    Copy

  2. Se o conector estiver ingerindo dados, aguarde até que a ingestão esteja completa. Isto é importante para garantir a total consistência dos dados.

  3. Se nenhuma ingestão estiver em andamento no momento, pare o conector chamando o seguinte procedimento armazenado:

CALL STOP_CONNECTOR();
Copy

Após remover o conector, você pode reinstalar o conector fazendo o seguinte:

Durante o processo de instalação:

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

  • Fornecer o mesmo URL 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.

Nota

Você também deve repetir os passos para configurar o conector novamente, incluindo o passo para habilitar as tabelas do ServiceNow para sincronização.

Se você criar novos objetos ou se criar uma nova função personalizada para o conector, você deve garantir que a função tenha os privilégios necessários. Para obter mais detalhes, consulte as próximas seções:

Reutilização da mesma função para o novo conector

Se você estiver usando a mesma função personalizada para o conector que você usou na instalação anterior do conector, você só precisa conceder os privilégios necessários em quaisquer novos objetos que você criou quando inicialmente instalou o conector. A função já deve ter os privilégios necessários em quaisquer outros objetos que você esteja reutilizando, incluindo as tabelas e exibições no banco de dados e esquema contendo os dados ingeridos.

Você também deve conceder a função personalizada ao conector como parte de uma nova instalação.

Nota

Se você executar CREATE OR REPLACE ROLE na função personalizada, a função é tecnicamente um novo objeto com o mesmo nome. Você deve seguir as etapas na seção abaixo.

Como usar uma nova função personalizada para o novo conector

Se você pretende usar uma nova função personalizada para o conector reinstalado, você deve conceder todos os privilégios listados em Criação de uma função personalizada para o conector a essa função, e você deve garantir que a nova função tenha os privilégios necessários nas tabelas e exibições do banco de dados e no esquema que contém os dados ingeridos.

Para conceder os privilégios necessários, conceda OWNERSHIP nas tabelas e exibições deste esquema à nova função personalizada.

Linguagem: Português