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¶

Esta seção descreve atualizações para valores de retorno NULL e valores de retorno para comprimento, precisão e escala nas condições da política de mascaramento (coletivamente: “atualizações de valores de retorno”) e como usar a exibição temporária BCR_2022_07_DDM_ROLLOUT (no esquema SNOWFLAKE.BCR_ROLLOUT) para mitigar essas atualizações de valores de retorno.

Durante o período de teste do pacote 2022_08 de alterações de comportamento, o Snowflake apresenta falhas nas consultas quando os seguintes fatores são verdadeiros:

• O pacote de alterações de comportamento está habilitado e

• Consulte uma coluna com política de mascaramento quando:

  • As condições da política de mascaramento retornam NULL para um campo de coluna que é NOT NULL.

    Por exemplo, a política de mascaramento retorna NULL para um campo que deve ser um número inteiro porque o tipo de dados da coluna é INTEGER.

  • 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 fornecer tempo suficiente para atualizar as condições da política de mascaramento para proteger os dados, o Snowflake fornece um esquema e uma exibição especial dentro do banco de dados SNOWFLAKE compartilhado para mapear a coluna da tabela, a política de mascaramento e um possível motivo para a falha de uma consulta de uma coluna protegida por uma política de mascaramento.

Observe que as atualizações do valor de retorno serão ativadas por padrão quando o pacote de alterações de comportamento 2023_01 (isto é, o período de cancelamento para o pacote de alterações de comportamento 2022_08) for publicado. Durante o período de cancelamento, a opção de desabilitar o pacote de alterações de comportamento fica disponível para adiar ainda mais os efeitos das atualizações de valores de retorno.

A exibição BCR_2022_07_DDM_ROLLOUT é temporária. O Snowflake removerá a exibição quando as atualizações de valores de retorno estiverem habilitadas de forma geral quando o pacote de mudança de comportamento 2023_02 for publicado. Nesse momento, não será mais possível 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.

Para obter mais detalhes sobre o processo de alteração de comportamento, consulte Política de alteração de comportamento.