ALTER VIEW¶

Sintaxe¶

ALTER VIEW [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER VIEW [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER VIEW [ IF EXISTS ] <name> UNSET COMMENT

ALTER VIEW [ IF EXISTS ] <name> SET SECURE

ALTER VIEW [ IF EXISTS ] <name> SET CHANGE_TRACKING =  { TRUE | FALSE }

ALTER VIEW <name> UNSET SECURE

ALTER VIEW <name> dataMetricFunctionAction

ALTER VIEW [ IF EXISTS ] <name> dataGovnPolicyTagAction

Onde:

dataMetricFunctionAction ::=

    SET DATA_METRIC_SCHEDULE = {
        '<num> MINUTE'
      | 'USING CRON <expr> <time_zone>'
      | 'TRIGGER_ON_CHANGES'
    }

  | UNSET DATA_METRIC_SCHEDULE

  | { ADD | DROP } DATA METRIC FUNCTION <metric_name>
      ON ( <col_name> [ , ... ]
      [ , TABLE <table_name>( <col_name> [ , ... ] ) ] )
      [ , <metric_name_2> ON ( <col_name> [ , ... ]
        [ , TABLE <table_name>( <col_name> [ , ... ] ) ] ) ]

  | MODIFY DATA METRIC FUNCTION <metric_name>
      ON ( <col_name> [ , ... ]
      [ , TABLE <table_name>( <col_name> [ , ... ] ) ] ) { SUSPEND | RESUME }
      [ , <metric_name_2> ON ( <col_name> [ , ... ]
        [ , TABLE <table_name>( <col_name> [ , ... ] ) ] ) { SUSPEND | RESUME } ]

Copy

dataGovnPolicyTagAction ::=
  {
      SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
    | UNSET TAG <tag_name> [ , <tag_name> ... ]
  }
  |
  {
      ADD ROW ACCESS POLICY <policy_name> ON ( <col_name> [ , ... ] )
    | DROP ROW ACCESS POLICY <policy_name>
    | DROP ROW ACCESS POLICY <policy_name> ,
        ADD ROW ACCESS POLICY <policy_name> ON ( <col_name> [ , ... ] )
    | DROP ALL ROW ACCESS POLICIES
  }
  |
  {
      SET AGGREGATION POLICY <policy_name>
        [ ENTITY KEY ( <col_name> [, ... ] ) ]
        [ FORCE ]
    | UNSET AGGREGATION POLICY
  }
  |
  {
      SET JOIN POLICY <policy_name>
        [ FORCE ]
    | UNSET JOIN POLICY
  }
  |
  ADD [ COLUMN ] [ IF NOT EXISTS ] <col_name> <col_type>
    [ [ WITH ] MASKING POLICY <policy_name>
          [ USING ( <col1_name> , <cond_col_1> , ... ) ] ]
    [ [ WITH ] PROJECTION POLICY <policy_name> ]
    [ [ WITH ] TAG ( <tag_name> = '<tag_value>'
          [ , <tag_name> = '<tag_value>' , ... ] ) ]
  |
  {
    { ALTER | MODIFY } [ COLUMN ] <col1_name>
        SET MASKING POLICY <policy_name>
          [ USING ( <col1_name> , <cond_col_1> , ... ) ] [ FORCE ]
      | UNSET MASKING POLICY
  }
  |
  {
    { ALTER | MODIFY } [ COLUMN ] <col1_name>
        SET PROJECTION POLICY <policy_name>
          [ FORCE ]
      | UNSET PROJECTION POLICY
  }
  |
  { ALTER | MODIFY } [ COLUMN ] <col1_name> SET TAG
      <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
      , [ COLUMN ] <col2_name> SET TAG
          <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
  |
  { ALTER | MODIFY } [ COLUMN ] <col1_name> UNSET TAG <tag_name> [ , <tag_name> ... ]
                   , [ COLUMN ] <col2_name> UNSET TAG <tag_name> [ , <tag_name> ... ]

Copy

Parâmetros¶

name

Especifica o identificador da visualização a ser alterada. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

RENAME TO new_name

Especifica o novo identificador da visualização; deve ser único para o esquema.

Para obter mais detalhes, consulte Requisitos para identificadores.

Você pode mover o objeto para um banco de dados e/ou esquema diferente enquanto opcionalmente renomeia o objeto. Para isso, especifique um valor qualificado new_name que inclua o novo banco de dados e/ou nome do esquema no formulário db_name.schema_name.object_name ou schema_name.object_name, respectivamente.

Nota

• O banco de dados e/ou esquema de destino já deve existir. Além disso, um objeto com o mesmo nome não pode já existir no banco de dados de destino; caso contrário, a instrução retorna um erro.

• É proibido mover um objeto para um esquema de acesso gerenciado a menos que o proprietário do objeto (ou seja, a função que tem o privilégio OWNERSHIP sobre o objeto) também possua o esquema de destino.

Quando um objeto é renomeado, outros objetos que fazem referência a ele devem ser atualizados com o novo nome.

SET ...

Especifica a propriedade a ser definida para a exibição:

SECURE

Especifica uma visualização como segura.

CHANGE_TRACKING = TRUE | FALSE

Especifica a habilitação ou desabilitação do rastreamento de alterações na tabela.

• TRUE habilita o rastreamento de alterações na exibição, e faz o ajuste em cascata em todas as tabelas subjacentes.

• FALSE desabilita o rastreamento de alterações na exibição, e faz o ajuste em cascata em todas as tabelas subjacentes.

COMMENT = 'string_literal'

Adiciona um comentário ou substitui um comentário existente para a exibição.

Nota

Você deve definir cada propriedade da visualização individualmente.

UNSET ...

Especifica a propriedade a ser removida para a exibição, o que a restaura para os padrões.

• SECURE

• COMMENT

Ao redefinir uma propriedade/parâmetro, especificar somente o nome; especificar um valor para a propriedade retornará um erro.

Nota

Você deve reinicializar cada propriedade de visualização individualmente.

Ações de função de métrica de dados (dataMetricFunctionAction)¶

DATA_METRIC_SCHEDULE ...

Especifica o agendamento para executar a função de métrica de dados periodicamente.

'num MINUTE'

Especifica um intervalo (em minutos) de espera inserido entre as execuções da função da métrica de dados. Aceita apenas números inteiros positivos.

Também oferece suporte à sintaxe num M.

Para funções de métricas de dados, use um dos seguintes valores: 5, 15, 30, 60, 720 ou 1440.

'USING CRON expr time_zone'

Especifica uma expressão cron e um fuso horário para executar periodicamente a função da métrica de dados. Oferece suporte a um subconjunto de sintaxe de utilitário cron padrão.

Para uma lista de fusos horários, consulte a lista de fusos horários do banco de dados tz.

A expressão cron consiste nos seguintes campos e o intervalo periódico deve ser de pelo menos 5 minutos:

# __________ minute (0-59)
# | ________ hour (0-23)
# | | ______ day of month (1-31, or L)
# | | | ____ month (1-12, JAN-DEC)
# | | | | _ day of week (0-6, SUN-SAT, or L)
# | | | | |
# | | | | |
  * * * * *

Copy

Os seguintes caracteres especiais são suportados:

*

Curinga. Especifica qualquer ocorrência do campo.

L

Significa “último”. Quando usado no campo do dia da semana, permite especificar construções como “a última sexta-feira” (“5L”) de um determinado mês. No campo do dia do mês, ele especifica o último dia do mês.

/{n}

Indica a enésima instância de uma determinada unidade de tempo. Cada quanta de tempo é computada independentemente. Por exemplo, se 4/3 estiver especificado no campo do mês, a função de métrica de dados será programada para abril, julho e outubro (ou seja, a cada 3 meses, começando com o quarto mês do ano). O mesmo cronograma é mantido nos anos seguintes. Ou seja, a função da métrica de dados não está programada para ser executada em janeiro (3 meses após a execução de outubro).

Nota

• Atualmente, a expressão cron avalia apenas em relação ao fuso horário especificado. Alterar o valor do parâmetro TIMEZONE para a conta (ou definir o valor no nível do usuário ou da sessão) não altera o fuso horário da função da métrica de dados.

• A expressão cron define todos os tempos de execução válidos para a função da métrica de dados. O Snowflake tenta executar uma função da métrica de dados com base neste cronograma; no entanto, qualquer tempo de execução válido é ignorado se uma execução anterior não tiver sido concluída antes do próximo tempo de execução válido começar.

• Quando tanto um dia específico do mês como um dia da semana são incluídos na expressão cron, a função da métrica de dados é programada em dias que satisfaçam o dia do mês ou o dia da semana. Por exemplo, DATA_METRIC_SCHEDULE = 'USING CRON 0 0 10-20 * TUE,THU UTC' programa uma função da métrica de dados no horário 0AM em qualquer dia de 10 a 20 e também em qualquer terça-feira ou quinta-feira fora dessas datas.

• A granularidade de tempo mais curta em cron é de minutos.

  Se uma função de métricas de dados for retomada durante o minuto definido em sua expressão cron, a primeira execução agendada da função de métrica de dados será a próxima ocorrência da instância da expressão cron. Por exemplo, se a função de métricas de dados agendada para ser executada diariamente à meia-noite (USING CRON 0 0 * * *) for retomada à meia-noite mais 5 segundos (00:00:05), a primeira execução da função de métrica de dados será programada para a meia-noite seguinte.

'TRIGGER_ON_CHANGES'

Especifica que a DMF é executada quando uma operação DML modifica a tabela, como inserir uma nova linha ou excluir uma linha.

É possível especificar 'TRIGGER_ON_CHANGES' para os seguintes objetos:

• Tabelas dinâmicas

• Tabelas externas

• Tabelas Apache Iceberg™

• Tabelas regulares

• Tabelas temporárias

• Tabelas transitórias

Você não pode especificar 'TRIGGER_ON_CHANGES' para as exibições.

Alterações na tabela como resultado de reclustering não acionam a execução da DMF.

{ ADD | DROP } DATA METRIC FUNCTION metric_name

Identificador da função de métrica de dados a ser adicionada à tabela ou exibição ou removida da tabela ou exibição.

ON ( col_name [ , ... ] [ , TABLE( table_name( col_name [ , ... ] ) ) ] )

As colunas da tabela ou exibição nas quais a função de métrica de dados será associada. Os tipos de dados das colunas devem corresponder aos tipos de dados das colunas especificados na definição da função de métrica de dados.

Se a função de métrica de dados aceitar uma segunda tabela como argumento, especifique o nome totalmente qualificado da tabela e suas colunas.

[ , metric_name_2 ON ( col_name [ , ... ] [ , TABLE( table_name( col_name [ , ... ] ) ) ] ) ]

Funções de métricas de dados adicionais para adicionar à tabela ou exibição. Use uma vírgula para separar cada função de métrica de dados e suas colunas especificadas.

Se a função de métrica de dados aceitar uma segunda tabela como argumento, especifique o nome totalmente qualificado da tabela e suas colunas.

MODIFY DATA METRIC FUNCTION metric_name

Identificador da função de métricas de dados a ser modificada.

ON ( col_name [ , ... ] [ , TABLE( table_name( col_name [ , ... ] ) ) ] ) { SUSPEND | RESUME }

Suspende ou retoma a função de métricas de dados nas colunas especificadas. Quando uma função de métrica de dados é definida para uma tabela ou exibição, a função de métricas de dados é automaticamente incluída na cronograma. Se a função de métrica de dados aceitar uma segunda tabela como argumento, especifique o nome totalmente qualificado da tabela e suas colunas.

• SUSPEND remove a função de métricas de dados do cronograma.

• RESUME traz uma função de métricas de dados suspensa de volta ao cronograma.

[ , metric_name_2 ON ( col_name [ , ... ] [ , TABLE(col_name [ , ... ] ) ] ) { SUSPEND | RESUME } ]

Funções de métricas de dados adicionais para suspender ou retomar. Use uma vírgula para separar cada função de métrica de dados e suas colunas especificadas. Se a função de métrica de dados aceitar uma segunda tabela como argumento, especifique o nome totalmente qualificado da tabela e suas colunas.

Para obter detalhes sobre os requisitos de controle de acesso para essas ações, consulte Privilégios de DMF.

Política de governança de dados e ações de tag (dataGovnPolicyTagAction)¶

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Especifica o nome da tag e o valor da cadeia de caracteres dela.

O valor de tag é sempre uma cadeia de caracteres, e o número máximo de caracteres do valor da tag é 256.

Para obter informações sobre como especificar tags em uma instrução, consulte Cotas de tags para objetos e colunas.

policy_name

Identificador da política; deve ser único para seu esquema.

As cláusulas a seguir se aplicam a todos os tipos de tabelas que suportam políticas de acesso a linhas, como, entre outras, tabelas, exibições e tabelas de eventos. Para simplificar, as cláusulas referem-se apenas a “tabela”.

ADD ROW ACCESS POLICY policy_name ON (col_name [ , ... ])

Adiciona um política de acesso a linhas à tabela.

Pelo menos um nome de coluna deve ser especificado. Colunas adicionais podem ser especificadas com uma vírgula que separa cada nome de coluna. Use esta expressão para adicionar uma política de acesso a linhas tanto a uma tabela de eventos como a uma tabela externa.

DROP ROW ACCESS POLICY policy_name

Descarta uma política de acesso a linhas da tabela.

Use esta cláusula para descartar a política da tabela.

DROP ROW ACCESS POLICY policy_name, ADD ROW ACCESS POLICY policy_name ON ( col_name [ , ... ] )

Descarta a política de acesso a linhas definida na tabela e adiciona uma política de acesso a linhas à mesma tabela em uma única instrução SQL.

DROP ALL ROW ACCESS POLICIES

Descarta todas as associações de política de acesso a linhas de uma tabela.

Esta expressão é útil quando uma política de acesso a linhas é descartada de um esquema antes de descartar a política de uma tabela de eventos. Use esta expressão para descartar as associações de política de acesso a linhas da tabela.

SET AGGREGATION POLICY policy_name

[ ENTITY KEY (col_name [ , ... ]) ] [ FORCE ]

Atribui uma política de agregação à tabela.

Use o parâmetro opcional ENTITY KEY para definir quais colunas identificam exclusivamente uma entidade dentro da tabela. Para obter mais informações, consulte Implementação de privacidade ao nível de entidade com políticas de agregação.

Use o parâmetro opcional FORCE para substituir atomicamente uma política de agregação existente pela nova política de agregação.

UNSET AGGREGATION POLICY

Desanexa uma política de agregação da tabela.

SET JOIN POLICY policy_name

[ FORCE ]

Atribui uma política de junção à tabela.

Use o parâmetro opcional FORCE para substituir atomicamente uma política de junção existente pela nova política de junção.

UNSET JOIN POLICY

Desvincula uma política de junção da tabela.

{ ALTER | MODIFY } [ COLUMN ] ...

USING ( col_name , cond_col_1 ... )

Especifica os argumentos para passar para a expressão SQL da política de mascaramento condicional.

A primeira coluna da lista especifica a coluna das condições da política para mascarar ou tokenizar os dados e deve corresponder à coluna para a qual a política de mascaramento é definida.

As colunas adicionais especificam as colunas a serem avaliadas para determinar se os dados em cada linha do resultado da consulta devem ser mascarados ou tokenizados quando uma consulta é feita na primeira coluna.

Se a cláusula USING for omitida, o Snowflake tratará a política de mascaramento condicional como uma política de mascaramento normal.

FORCE

Substitui uma política de mascaramento ou projeção que está atualmente definida em uma coluna por uma política diferente em uma única instrução.

Observe que a utilização da palavra-chave FORCE com uma política de mascaramento exige o tipo de dados da política na instrução ALTER TABLE (isto é, STRING) para corresponder ao tipo de dados da política de mascaramento atualmente definida na coluna (isto é, STRING).

Se uma política de mascaramento não estiver definida atualmente na coluna, a especificação dessa palavra-chave não tem efeito.

Para obter mais detalhes, consulte: Substituição de uma política de mascaramento em uma coluna ou Substituir uma política de projeção.

Notas de uso: geral¶

• É proibido mover uma exibição para um esquema de acesso gerenciado (usando a sintaxe ALTER VIEW … RENAME TO), a menos que o proprietário da exibição (ou seja, a função que tem o privilégio OWNERSHIP na exibição) também seja o proprietário do esquema de destino.

• Para políticas de mascaramento:

  • A cláusula USING e a palavra-chave FORCE são ambas opcionais; nenhuma delas é necessária para definir uma política de mascaramento em uma coluna. A cláusula USING e a palavra-chave FORCE podem ser usadas separadamente ou em conjunto. Para obter mais detalhes, consulte:

    • Aplicação de uma política de mascaramento condicional em uma coluna

    • Substituição de uma política de mascaramento em uma coluna

  • Uma única política de mascaramento que utilize colunas condicionais pode ser aplicada a várias tabelas, desde que a estrutura de colunas da tabela corresponda às colunas especificadas na política.

  • Ao modificar uma ou mais colunas da tabela com uma política de mascaramento ou a própria tabela com uma política de acesso a linhas, use a função POLICY_CONTEXT para simular uma consulta na(s) coluna(s) protegida(s) por uma política de mascaramento e na tabela protegida por uma política de acesso a linhas.

• Uma única política de mascaramento que utilize colunas condicionais pode ser aplicada a várias exibições, desde que a estrutura de colunas da exibição corresponda às colunas especificadas na política.

• Para políticas de acesso a linhas:

  • O Snowflake oferece suporte à adição e ao descarte de políticas de acesso a linhas em uma única instrução SQL.

    Por exemplo, para substituir uma política de acesso a linhas que já esteja definida em uma tabela por uma política diferente, primeiro descarte a política de acesso a linhas e depois adicione a nova política.

  • Para determinado recurso (ou seja, tabela ou exibição), para ADD ou DROP uma política de acesso a linhas, você deve ter o privilégio APPLY ROW ACCESS POLICY no esquema, ou o privilégio OWNERSHIP no recurso e o privilégio APPLY no recurso da política de acesso a linhas.

  • Uma tabela ou exibição só pode ser protegida por uma política de acesso a linhas de cada vez. A adição de uma política falhará se o corpo da política se referir a uma coluna de exibição ou tabela protegida por uma política de acesso a linhas ou à coluna protegida por uma política de mascaramento.

    Da mesma forma, a adição de uma política de mascaramento a uma coluna da tabela falhará se o corpo da política de mascaramento se referir a uma tabela protegida por uma política de acesso a linhas ou outra política de mascaramento.

  • As políticas de acesso a linhas não podem ser aplicadas a exibições do sistema ou funções de tabela.

  • Semelhante a outras operações DROP <objeto>, o Snowflake retornará um erro se tentar descartar uma política de acesso a linhas de um recurso que não tenha uma política de acesso a linhas adicionada a ele.

  • Se um objeto tiver uma política de acesso a linhas e uma ou mais políticas de mascaramento, a política de acesso a linhas será avaliada primeiro.

• Em relação aos metadados:

  Atenção

  Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Notas de uso: funções de métricas de dados¶

Adicione uma DMF a uma tabela:

Antes de adicionar uma função de métrica de dados a uma tabela, você deve:

• Definir o agendamento para a execução da função de métrica de dados. Para obter mais detalhes, consulte DATA_METRIC_SCHEDULE.

• Configure a tabela de eventos para armazenar os resultados da chamada da função de métrica de dados. Para obter mais detalhes, consulte Visualize os resultados da DMF:.

• Certifique-se de que a exibição da tabela não seja concedida a um compartilhamento, pois você não pode definir uma função de métrica de dados em uma tabela ou exibição compartilhada.

Adicionalmente:

• É possível adicionar uma função de métricas de dados a uma tabela, tabela externa, exibição ou exibição materializada. Não é possível definir uma função de métricas de dados em nenhum outro tipo de tabela, como uma tabela dinâmica.

• Quando você especifica uma coluna, o Snowflake usa a posição ordinal. Se você renomear uma coluna depois de adicionar uma função de métrica de dados à tabela ou exibição, a associação da função de métrica de dados à coluna permanecerá válida.

• Somente uma função de métrica de dados desse tipo pode ser adicionada a uma coluna. Por exemplo, uma função da métrica de dados NULL_COUNT não pode ser adicionada a uma única coluna duas vezes.

• Se você remover uma coluna depois de adicionar uma função de métrica de dados que faz referência à coluna, o Snowflake não poderá avaliar a função de métrica de dados.

• Não há suporte para fazer referência a uma coluna virtual.

Descarte uma DMF de uma tabela:

• Remova a função de métrica de dados da tabela antes de usar o comando DROP FUNCTION para remover a função de métrica de dados do sistema.

• Você pode usar a função DATA_METRIC_FUNCTION_REFERENCES para identificar a tabela e visualizar objetos que têm uma função de métrica de dados definida neles.

Agendamento de uma DMF

Leva dez minutos para que o cronograma entre em vigor depois que ele é definido.

Da mesma forma, leva dez minutos uma vez que a DMF não está definida para que as alterações de agendamento entrem em vigor. Para obter mais informações, consulte Como agendar suas DMFs para serem executadas.

Exemplos¶

Renomear a exibição view1 como view2:

ALTER VIEW view1 RENAME TO view2;

Converter uma exibição em uma exibição segura:

ALTER VIEW view1 SET SECURE;

Reverter uma exibição segura para uma exibição regular:

ALTER VIEW view1 UNSET SECURE;

Aplicar uma política de mascaramento de segurança em nível de coluna a uma coluna de exibição:

-- single column

ALTER VIEW user_info_v MODIFY COLUMN ssn_number SET MASKING POLICY ssn_mask_v;

-- multiple columns

ALTER VIEW user_info_v MODIFY
  COLUMN ssn_number SET MASKING POLICY ssn_mask_v,
  COLUMN dob SET MASKING POLICY dob_mask_v
  ;

Remover uma política de mascaramento de segurança em nível de coluna de uma coluna da exibição:

-- single column

ALTER VIEW user_info_v MODIFY COLUMN ssn_number UNSET MASKING POLICY;

-- multiple columns

ALTER VIEW user_info_v MODIFY
  COLUMN ssn_number UNSET MASKING POLICY,
  COLUMN dob UNSET MASKING POLICY
  ;

O exemplo seguinte adiciona uma política de acesso a linhas a uma exibição. Após definir as políticas, é possível verificar os objetos referenciados verificando o esquema de informações.

ALTER VIEW v1
  ADD ROW ACCESS POLICY rap_v1 ON (empl_id);

O exemplo a seguir descarta uma política de acesso a linhas de uma visualização. Verifique se as políticas foram descartadas consultando o esquema de informações.

ALTER VIEW v1
  DROP ROW ACCESS POLICY rap_v1;

O exemplo a seguir mostra como combinar a adição e a eliminação de políticas de acesso a linhas em uma única instrução SQL para uma exibição. Verifique os resultados conferindo o esquema de informação.

ALTER VIEW v1
  DROP ROW ACCESS POLICY rap_v1_version_1,
  ADD ROW ACCESS POLICY rap_v1_version_2 ON (empl_id);

O exemplo a seguir define uma política de junção em uma exibição:

ALTER VIEW join_view
  SET JOIN POLICY jp1;