Notas de lançamento de Snowflake Connector for ServiceNow® V2¶

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• Corrigido um problema com a persistência do tamanho da página ao recarregar uma tabela.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• Corrigido um problema que podia fazer com que a exportação do estado do conector falhasse quando as expressões de filtragem de linha eram usadas em valores de cadeia de caracteres.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• Corrigido um problema que poderia causar uma falha na análise da resposta do HTTP. Em alguns casos, esse problema pode fazer com que o conector não consiga ingerir dados do ServiceNow®.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

• Foi adicionado suporte a cronogramas contínuos. Você pode usar esse recurso para definir um cronograma de ingestão para até 20 tabelas que serão executadas a cada minuto. O Snowflake recomenda o uso de cronogramas contínuos com cuidado e somente para tabelas que exigem dados quase em tempo real no Snowflake. Para ativar esse recurso, você pode usar os procedimentos ENABLE_TABLE ou CONFIGURE_TABLES_SCHEDULE. Para saber mais, consulte Especificação do cronograma de sincronização.

• O número máximo de tabelas que podem ser ingeridas simultaneamente foi aumentado de 30 para 50. Essa atualização permite uma melhor utilização do warehouse e melhora o desempenho geral. Para saber mais, consulte Escalonamento do conector.

Correções de bugs¶

• O conector é mais estável e tem melhor desempenho ao ingerir várias tabelas em paralelo.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• Corrigido um erro que fazia com que a exportação do estado do conector falhasse.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• Corrigido um bug que fazia com que o processo de análise da resposta da API de ServiceNow® falhasse quando um nome de cabeçalho na resposta não correspondia ao formato esperado.

• Corrigido um bug que fazia com que a exportação do estado e da configuração do conector falhasse quando uma recarga filtrada era executada em uma tabela.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

• O procedimento DELETE_TABLE agora aceita um parâmetro booliano opcional drop_related_objects. Quando esse parâmetro é definido como true, o procedimento descarta todos os objetos relacionados à tabela, como as exibições niveladas, a tabela de registro de eventos e a tabela de sumidouros.

• O recurso de recarga filtrada agora suporta a detecção de exclusões e pode filtrar esses registros ao usar o parâmetro sys_ids no procedimento RELOAD_TABLE. Antes desta versão, o recurso de recarga filtrada detectava apenas atualizações e inserções de dados.

Correções de bugs¶

• Correção do erro em CONNECTOR_STATS que exibia estatísticas de linhas ingeridas ao executar o recarregamento filtrado.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• Reverteu uma otimização de desempenho que poderia causar um aumento no consumo do warehouse.

Mudanças de comportamento¶

• Para ver os detalhes de configuração das tabelas que você recarregar, use a exibição RELOADED_TABLES em vez da exibição CONFIGURED_TABLES. Essa nova exibição inclui os valores de configuração da tabela da exibição CONFIGURED_TABLES, além de novas colunas que fornecem informações sobre a configuração de recarga que foi usada para a tabela e o status de recarga da tabela. Para obter mais informações, consulte Sobre o monitoramento do conector.

Novos recursos¶

• Foi adicionado suporte ao fluxo de concessão de credenciais do cliente OAuth. Ao configurar OAuth, recomendamos que você use esse fluxo em vez do fluxo de concessão de código de autenticação OAuth. Para obter mais informações, consulte Configuração do OAuth. Se o conector já estiver configurado com outro fluxo OAuth e você o configurar para usar o fluxo de concessão de credenciais de cliente, recomendamos que execute as seguintes tarefas, se possível:

  • Recrie os objetos de integração de segurança e segredo para usar as credenciais do cliente. Para obter instruções, consulte Criação de uma integração de segurança e Criação de um objeto secreto.

  • Atualize a conexão com a instância ServiceNow para usar as novas credenciais. Para obter mais informações, consulte Atualização da conexão com a instância do ServiceNow®.

• Foi adicionado um novo parâmetro de configuração ao procedimento RELOAD_TABLE. Esse parâmetro permite recarregar registros específicos em uma tabela em vez de toda a tabela. Para obter detalhes, consulte Recarga filtrada.

• Nas exibições que contêm campos de referência, as colunas com o sufixo __DISPLAY_VALUE que contêm dados para campos de referência agora exibem os dados mais recentes. Anteriormente, essas colunas sempre retornavam o valor de exibição para o valor bruto ingerido da mesma tabela. Para ativar esse recurso, inclusive em exibições existentes, chame o procedimento armazenado CREATE_VIEW_WITH_DISPLAY_VALUES. Para obter mais informações, consulte Criação de uma exibição contendo campos de referência.

Correções de bugs¶

• Melhoria no desempenho da solicitação de teste inicial quando uma nova tabela é habilitada para ingestão.

• Melhoria no tratamento de erros quando o código de erro retornado está em um formato diferente do esperado.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

Corrigido um problema em que as colunas de referência em exibições niveladas exibiam dados incompletos quando a exibição continha dados de uma tabela com fetch_display_values ativado.

Mudanças de comportamento¶

As visualizações niveladas agora sempre exibem as colunas em ordem alfabética. Anteriormente, essas visualizações às vezes exibiam colunas em ordem aleatória.

Novos recursos¶

Não aplicável

Correções de bugs¶

• Correção de um problema em que os dados incluídos em uma exibição se deslocavam entre as colunas quando a exibição continha campos de referência.

• Correção de um problema em que as exibições niveladas não eram recriadas corretamente.

• Para tabelas com fetch_display_values habilitado, foi corrigido um problema em que o conector obtinha apenas uma única página de até 10.000 registros para uma tabela antes que o processo de ingestão fosse interrompido. No entanto, você deve recarregar essas tabelas para aplicar a correção a elas, incluindo tabelas com fetch_display_values habilitado por meio das configurações globais do conector. Para obter instruções sobre como recarregar uma tabela, consulte Recarregamento de dados em uma tabela.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

Correção de um problema em que a chamada do procedimento armazenado CONFIGURE_DISPLAY_VALUE_FETCHING não conseguia configurar os valores de exibição padrão das tabelas e fazia com que Snowflake Connector for ServiceNow® V2 parasse de responder.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

• Um novo procedimento CONFIGURE_DISPLAY_VALUE_FETCHING foi adicionado. É usado para definir a configuração padrão global para tratar os valores de exibição. A sincronização dos valores de exibição também pode ser configurada no nível da tabela, usando o procedimento ENABLE_TABLE.

• Os dados com valores de exibição resolvidos agora podem ser obtidos, em vez de apenas dados brutos.

Correções de bugs¶

• Correções no processo de exportação do estado do conector.

• Melhoria no tratamento dos erros de DNS.

• Os procedimentos CREATE_VIEW_WITH_DISPLAY_VALUES e ENABLE_REFERENCED_TABLES agora lidam com a configuração de colunas incluídas.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• O conector agora trata uma exceção quando uma tabela que está sendo exportada tem uma configuração incompleta.

• O processo de upgrade não falhará mais se o procedimento GET_TROUBLESHOOTING_DATA não for criado.

• O conector não falha mais quando um instantâneo do estado interno não é criado devido ao seu tamanho.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• Adição de migração para oferecer suporte a estados de sincronização antigos na exportação de dados.

Mudanças de comportamento¶

• O processo de exportação para armazenar o estado interno do conector foi alterado.

  Além de armazenar metadados na tabela __CONNECTOR_STATE_EXPORT, os dados também são divididos em várias tabelas com o sufixo _SFSDKEXPORT_V1.

Novos recursos¶

• Snowflake Connector for ServiceNow® V2 agora oferece suporte à recuperação de desastres em outra região.

• Adição de suporte para configurar a sincronização de exclusão no nível da tabela usando o procedimento ENABLE_TABLE.

  Para obter mais informações sobre como usar o procedimento ENABLE_TABLE, consulte Habilitação de uma única tabela usando configuração personalizada.

Correções de bugs¶

• As respostas inesperadas da ServiceNow API agora são tratadas corretamente nos procedimentos como CHECK_ROW_COUNT.

Mudanças de comportamento¶

• O compartilhamento de eventos agora é obrigatório para novas instalações.

Novos recursos¶

• Agora você pode definir um tamanho de página de tabela especificado com o procedimento RESET_PAGE_SIZE em vez de usar o valor padrão do conector.

• Se o tamanho de página padrão do conector tiver sido definido com um valor inválido, o conector usará o valor recomendado de 10.000.

Correções de bugs¶

• A ingestão falha quando uma tarefa de trabalho atinge o tempo limite da API ao descobrir o tamanho inicial da página da tabela.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

• Adicionar tempo limite ao estabelecer a conexão http.

Correções de bugs¶

Não aplicável

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• As atualizações incrementais não falham mais se o Snowflake não receber o carimbo de data/hora do registro mais recente na tabela ingerida.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• Atualizações incrementais não falham mais quando a tabela de log de evento está vazia.

• A ingestão incremental não falha mais quando um lote recuperado está vazio devido a linhas desatualizadas durante atualizações de registro da origem.

Mudanças de comportamento¶

Modificação das regras de classificação de solicitação da ServiceNow API aplicadas durante atualizações incrementais para eliminar a perda de dados durante a leitura de dados de várias réplicas de leitura.

Novos recursos¶

Não aplicável

Correções de bugs¶

O tamanho da página não é mais reduzido quando a instância de ServiceNow não está acessível.

Mudanças de comportamento¶

Não aplicável

Novos recursos¶

Não aplicável

Correções de bugs¶

• Validação de configuração corrigida no procedimento UPDATE_CONNECTION_CONFIGURATION.

Mudanças de comportamento¶

• Uma solicitação do carimbo de data/hora mais recente é adicionada no início de atualizações e exclusões.

Novos recursos¶

• O procedimento UPDATE_CONNECTION_CONFIGURATION é adicionado. Este procedimento permite alterar os objetos de integração de acesso externo e segredo usados ​​pelo conector.

• O cabeçalho do agente do usuário nas solicitações HTTP do conector agora está definido como snowflake-connector-for-service-now.

Correções de bugs¶

• Trate os erros de tempo limite do cliente HTTP de forma adequada.

  Reduza o tamanho da página em caso de erro desse tipo.

• ServiceNow® e as diferenças de fuso horário do Snowflake não causam mais perda de dados.

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

Não aplicável.

Correções de bugs¶

• Correção de script de migração para determinados usuários.

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

Não aplicável.

Correções de bugs¶

• Correção do procedimento RELOAD_TABLE quando row_filter e data_range_start_time estiverem definidos. Anteriormente, os estados de sincronização da filtragem de linha não eram limpos corretamente.

• Melhore o tratamento de erro no processo de ingestão de dados quando o conector não for capaz de superar erros relacionados à autenticação. Nesses casos, o conector agora deve ser capaz de detectar o erro mais cedo e interromper o processo de ingestão.

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

• O campo row_filter no procedimento ENABLE_TABLE agora aceita um número arbitrário de caracteres de espaço em branco na expressão de filtragem, em vez de permitir apenas um único espaço entre os elementos da expressão.

  Para obter mais informações, consulte Habilitação de uma única tabela usando configuração personalizada.

Correções de bugs¶

• Durante o recarregamento da tabela, o filtro de linha e o filtro de coluna agora são levados em conta.

• O filtro de linha agora funciona como esperado para tabelas sem uma coluna sys_updated_on

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

Os procedimentos CHECK_ROW_COUNT, ENABLE_TABLE (sem parâmetros de configuração personalizados) e SHOW_REFERENCES_OF_TABLE agora podem ser chamados em uma tarefa de propriedade do usuário.

Correções de bugs¶

Não aplicável.

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

A filtragem de linhas agora está disponível. A filtragem de linhas oferece suporte à filtragem de linhas de tabela ingeridas com base em condições avaliadas em relação às colunas da tabela. A condição de filtragem de linha é definida usando o procedimento ENABLE_TABLE.

Para obter mais informações, consulte Habilitação de uma única tabela usando configuração personalizada em Configuração da ingestão de dados para seus dados do ServiceNow®.

Correções de bugs¶

Melhore o desempenho do script de migração da versão anterior.

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

Não aplicável

Correções de bugs¶

Melhore o desempenho do script de migração da versão anterior.

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

Adicione uma maneira padrão de obter o esquema de uma tabela ao iniciar sua ingestão. Isso deve ajudar em um cenário em que o conector não conseguiu começar a ingerir uma tabela por causa das ACLs encontradas na primeira linha ingerida.

Correções de bugs¶

• Corrija RUN_HEALTHCHECK, pois às vezes ele poderia falhar ao enviar o status do conector em um cenário específico.

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

Alteração do ponto de extremidade para buscar o esquema da tabela. A partir da versão 5.4.0 e posteriores, a função ADMIN em ServiceNow® não é mais necessária para usar os procedimentos CREATE_VIEW_WITH_DISPLAY_VALUES, SHOW_REFERENCES_OF_TABLE e ENABLE_TABLE (ao usar filtragem de coluna).

Correções de bugs¶

A partir da versão 5.4.0 e posteriores, a nova tabela de log de evento DELETE inclui a coluna RAW, que é definida como um valor do evento de atualização mais recente em vez do primeiro evento de inserção. Os eventos da tabela de log de evento existentes anteriormente permanecem inalterados.

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

Não aplicável.

Correções de bugs¶

Corrigido o tratamento do valor nulo da propriedade journal_table no objeto passado para o procedimento FINALIZE_CONNECTOR_CONFIGURATION. O parâmetro journal_table agora também pode ser ignorado.

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

Adicione o table_name opcional e argumentos sys_id para FINALIZE_CONNECTOR_CONFIGURATION para ajudar na validação da tabela de diário.

Correções de bugs¶

• Melhorar validação de URL em SET_CONNECTION_CONFIGURATION para dar suporte aos domínios ServiceNow® personalizados.

Mudanças de comportamento¶

Não aplicável.

Novos recursos¶

O argumento max_sys_created_on no procedimento CHECK_ROW_COUNT agora é definido como NULL por padrão.

Correções de bugs¶

• Não inicie o relatório de verificação de integridade se a configuração não tiver sido concluída com sucesso.

• Conserte SHOW_REFERENCES_OF_TABLE para incluir autorreferências de uma determinada tabela no valor retornado.

• Conserte CREATE_VIEW_WITH_DISPLAY_VALUES para lidar com situações em que a tabela faz referência a si mesma.

Mudanças de comportamento¶

• A API da função externa que faz chamadas ServiceNow® é substituída por acesso externo.

• Assinaturas e comportamento de muitos procedimentos mudaram. A divisão de responsabilidades pode ser verificada na tabela abaixo:

Procedimento anterior	Novo procedimento
CONFIGURE_CONNECTOR	Vários procedimentos especializados CONFIGURE_*.
CONFIGURE_WAREHOUSE	UPDATE_WAREHOUSE
STOP_CONNECTOR	PAUSE_CONNECTOR
START_CONNECTOR	Vários procedimentos para instalar o aplicativo ao usar planilhas.
PREFILL_CONFIG_TABLE	GET_AVAILABLE_TABLES
ENABLE_TABLE_WITH_COLUMNS	ENABLE_TABLE
ENABLE_TABLES(VARCHAR, BOOLEAN)	ENABLE_TABLES(ARRAY), DISABLE_TABLES(ARRAY)
TEST_SN_CONNECTION	TEST_CONNECTION
CHECK_SN_ROW_COUNT	CHECK_ROW_COUNT
GET_STATUS
GET_CONNECTION_STATUS
GET_VERSION
RUN_UPGRADE

• Os procedimentos retornam um objeto com propriedade response_code. O resultado do procedimento com um motivo de erro opcional é exibido diretamente na resposta.

• Assinaturas e comportamento de diversas visualizações foram alterados. A divisão de responsabilidades pode ser verificada na tabela abaixo:

  Exibição anterior	Nova exibição
  ENABLED_TABLES	CONFIGURED_TABLES, TABLES_STATE
  CONNECTOR_RUNS_STATE	Incluído no procedimento GET_TROUBLESHOOTING_DATA.
  CONNECTOR_STATS	AGGREGATED_CONNECTOR_STATS
  	SYNC_STATUS

Novos recursos¶

Não aplicável.

Correções de bugs¶

Não aplicável.