Gerenciamento de mudanças de comportamento¶

Visão geral¶

Snowflake implementa mudanças de comportamento mensalmente em pacotes incluídos versões regulares. Durante o período de teste e o período de recusa para cada pacote de mudança de comportamento, você pode ativar ou desativar o pacote em sua conta. Este documento explica como verificar se um determinado pacote está habilitado em sua conta e como habilitá-lo ou desabilitá-lo.

Neste documento, o nome do pacote de mudança de comportamento está no formato YYYY_NN. Para obter os nomes dos pacotes de mudança de comportamento disponíveis atualmente, consulte Log de mudança de comportamento.

Verificação do status de um pacote de mudança de comportamento em sua conta¶

Para verificar se um pacote de mudança de comportamento específico está ativado em sua conta, chame a função SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS. Por exemplo, para verificar o status do pacote denominado 2024_02:

SELECT SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS('2024_02');

+-------------------------------------------------+
| SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS('2024_02') |
|-------------------------------------------------|
| DISABLED                                        |
+-------------------------------------------------+

Para verificar o status de todos os pacotes de mudança de comportamento disponíveis atualmente, chame a função SYSTEM$SHOW_ACTIVE_BEHAVIOR_CHANGE_BUNDLES:

SELECT SYSTEM$SHOW_ACTIVE_BEHAVIOR_CHANGE_BUNDLES();

+--------------------------------------------------------------------------------------------------------------+
| SYSTEM$SHOW_ACTIVE_BEHAVIOR_CHANGE_BUNDLES()                                                                 |
|--------------------------------------------------------------------------------------------------------------|
| [{"name":"2023_08","isDefault":true,"isEnabled":true},{"name":"2024_01","isDefault":false,"isEnabled":true}] |
+--------------------------------------------------------------------------------------------------------------+

Habilitação de um pacote de mudança de comportamento em sua conta¶

Para ativar uma mudança de comportamento específica na sua conta, chame a função SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE. Por exemplo, para ativar o pacote denominado 2024_02:

SELECT SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02');

+-------------------------------------------------+
| SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02') |
|-------------------------------------------------|
| ENABLED                                         |
+-------------------------------------------------+

Desabilitação de um pacote de mudança de comportamento em sua conta¶

Para desativar uma mudança de comportamento específica em sua conta, chame SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE. Por exemplo, para desativar o pacote denominado 2024_02:

SELECT SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02');

+-------------------------------------------------+
| SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02')|
|-------------------------------------------------|
| DISABLED                                        |
+-------------------------------------------------+

Determinação da versão atual da sua conta¶

Para verificar a versão atual do Snowflake que está em sua conta, chame a função CURRENT_VERSION. Por exemplo:

SELECT CURRENT_VERSION();

Copy

+-------------------+
| CURRENT_VERSION() |
|-------------------|
| 8.5.1             |
+-------------------+

Mitigação de atualizações de valores de retorno da política de mascaramento¶

No pacote 2024_04, há alterações nos valores de precisão e escala nas condições da política de mascaramento (coletivamente: “atualizações de valor de retorno”). Uma consulta em uma coluna protegida por uma política de mascaramento falha quando o seguinte é verdadeiro:

• O pacote está ativado.

• As condições da política de mascaramento retornam um valor cuja precisão é maior que a precisão da coluna à qual a política de mascaramento é atribuída.

Se a escala do valor de retorno for maior que a escala da coluna, o valor será truncado para corresponder à escala da coluna.

Se quiser aplicar o novo comportamento a uma política preexistente, crie uma nova política de mascaramento e substitua a política preexistente usando a palavra-chave FORCE.

Quando o pacote estiver habilitado, você poderá testar o comportamento da seguinte maneira:

1. Criar uma política:

   CREATE MASKING POLICY MP AS (s string)
   RETURNS STRING -> 'abcdef';
   

   Copy

2. Atribuir a política:

   CREATE TABLE t(col1 string(2));
   
   ALTER TABLE t MODIFY COLUMN col1 SET MASKING POLICY mp;
   

   Copy

3. Consultar a coluna (falha):

   SELECT * FROM t;
   

   Copy

Para determinar o impacto dessa alteração e dar tempo suficiente para atualizar as condições da política de mascaramento para proteger os dados, consulte a exibição SNOWFLAKE.BCR_ROLLOUT.BCR_2024_03_DDM_ROLLOUT para entender como as futuras atualizações do valor de retorno afetarão sua conta.

A exibição BCR_2024_03_DDM_ROLLOUT é temporária. A Snowflake removerá a exibição quando as atualizações de valores de retorno estiverem geralmente ativadas em um pacote futuro de mudança de comportamento. Nesse momento, você não conseguirá consultar a exibição para determinar as colunas e políticas afetadas, ou evitar a consulta de colunas ou falhas nas operações de atribuição da política de mascaramento devido a atualizações dos valores de retorno.

A exibição registra dados a partir de março de 2024. Se uma consulta na exibição demorar muito para ser concluída, você poderá especificar as variáveis de sessão de data de início e data de término usando um comando SET. Essas variáveis ajudam a reduzir o número de linhas a serem avaliadas ao consultar a exibição. Por exemplo:

SET DDM_CASTING_BCR_START_DATE = '2024-03-01';
SET DDM_CASTING_BCR_END_DATE = '2024-04-03';

Copy