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, bundle_name é o nome do pacote de mudança de comportamento no formato YYYY_NN, encontrado no 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, use a função SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS com o bundle_name como argumento:

SELECT SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS('2021_02');

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

Copy

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

Para ativar uma determinada mudança de comportamento em sua conta, use a função SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE e especifique o bundle_name que contém a mudança:

SELECT SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2021_02');

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

Copy

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

Para desativar uma determinada mudança de comportamento em sua conta, use a função SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE e especifique o bundle_name que contém a mudança:

SELECT SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE('2021_02');

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

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.