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             |
+-------------------+

Copy

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

Em um pacote de lançamento de mudança de comportamento futuro, Snowflake planeja retornar valores de comprimento, precisão e escala em condições de política de mascaramento (coletivamente: «atualizações de valor de retorno»). Quando essas atualizações de valor de retorno são feitas, uma consulta em uma coluna protegida por uma política de mascaramento falhará quando o seguinte for verdadeiro:

• O pacote está ativado.

• As condições da política de mascaramento retornam um valor cujo comprimento, escala ou precisão é maior que o comprimento, escala ou precisão da coluna para a qual a política de mascaramento está atribuída. Por exemplo:

  Criar uma política:

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

  Copy

  Atribuir a política:

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

  Copy

  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_2022_07_DDM_ROLLOUT para entender como as futuras atualizações do valor de retorno afetarão sua conta.

A exibição BCR_2022_07_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 visualização registra dados a partir de julho 2022. 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 START_DATE = '2023-02-28';
SET END_DATE = '2023-11-30';

Copy