ALTER SNAPSHOT SET — Deprecated¶

Sintaxe¶

ALTER SNAPSHOT SET <name> ADD SNAPSHOT

ALTER SNAPSHOT SET <name> APPLY SNAPSHOT POLICY <policy_name> [ FORCE ]

ALTER SNAPSHOT SET <name> SUSPEND SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

ALTER SNAPSHOT SET <name> RESUME SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

ALTER SNAPSHOT SET <name> DELETE SNAPSHOT IDENTIFIER '<snapshot_id>'

ALTER SNAPSHOT SET <name> MODIFY SNAPSHOT IDENTIFIER '<snapshot_id>' { ADD | REMOVE } LEGAL HOLD

ALTER SNAPSHOT SET <name> SET COMMENT = '<string_literal>'

ALTER SNAPSHOT SET <name> UNSET COMMENT

ALTER SNAPSHOT SET <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER SNAPSHOT SET <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

Parâmetros¶

name

Especifica o identificador do conjunto de instantâneos.

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.

Para obter mais informações, consulte Requisitos para identificadores.

ADD SNAPSHOT

Crie um instantâneo no conjunto manualmente. Se a política de instantâneos não incluir um cronograma para fazer novos backups, é assim que você faz um novo backup da tabela, esquema ou banco de dados incluído no conjunto de instantâneos. Também é possível fazer novos backups no conjunto de instantâneos a qualquer momento, mesmo quando os backups acontecem regularmente.

APPLY SNAPSHOT POLICY policy_name [ FORCE ]

Especifica a política de instantâneos a ser anexada ao conjunto de instantâneos.

A opção FORCE substitui uma política existente em um conjunto de instantâneos. Você poderá usá-la apenas se a política antiga não tiver um bloqueio de retenção.

Importante

Aplicar uma política de instantâneos com um bloqueio de retenção a um conjunto de instantâneos é irreversível. Devido às sólidas garantias necessárias para a conformidade regulatória, depois de colocar um bloqueio de retenção em um conjunto de instantâneos, não será possível revogar o bloqueio. O suporte Snowflake também não pode revogar esse bloqueio de retenção. Planeje com cuidado antes de definir um bloqueio de retenção em um conjunto de instantâneos com um longo período de expiração, para evitar cobranças inesperadas de armazenamento para conjuntos de instantâneos não excluíveis e para os esquemas e bancos de dados que os contêm.

Se uma organização Snowflake for excluída, ela deixará de ser um cliente Snowflake. Nesse caso, o Snowflake exclui todos os instantâneos, incluindo aqueles com bloqueios de retenção. A exclusão de uma organização Snowflake requer o envolvimento do suporte Snowflake. Não é algo que um administrador possa fazer por acidente.

SUSPEND SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

Suspenda uma política de instantâneos no conjunto de instantâneos. Você pode suspender a política de instantâneo inteira ou apenas as operações de criação ou expiração. Quando você especifica SUSPEND SNAPSHOT POLICY sem as palavras-chave CREATION ou EXPIRATION, o Snowflake suspende os aspectos tanto de criação quanto de expiração da política. Para obter mais informações, consulte Suspensão da política de backup em um conjunto de backups.

RESUME SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

Retome uma política de instantâneos suspensa no conjunto. Você pode retomar a política de instantâneos inteira ou apenas as operações de criação ou expiração. Quando você especifica RESUME SNAPSHOT POLICY sem as palavras-chave CREATION ou EXPIRATION, o Snowflake retoma os aspectos tanto de criação quanto de expiração da política. Para obter mais informações, consulte Retomada da política de backup em um conjunto de backups.

DELETE SNAPSHOT IDENTIFIER 'snapshot_id'

Delete a snapshot in the snapshot set by ID. The snapshot ID is a UUID value, in the format returned by the UUID_STRING function. Snowflake only allows deleting the oldest snapshot from the snapshot set. For more information, see Exclusão do backup de um conjunto de backups.

MODIFY SNAPSHOT IDENTIFIER 'snapshot_id' { ADD | REMOVE } LEGAL HOLD

Adiciona ou remove uma retenção legal de um instantâneo especificado dentro do conjunto de instantâneos. Para obter mais informações sobre retenções legais de instantâneos WORM, consulte Retenção legal. Para exemplos de uso desta cláusula, consulte Adicionar e remover retenções legais.

SET COMMENT = 'string_literal'

Associe um comentário ao conjunto de instantâneos.

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 Tag quotas.

UNSET ...

Especifica uma ou mais propriedades e/ou parâmetros a serem removidos da definição do conjunto de instantâneos, o que os redefine aos padrões:

• property_name

• param_name

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

Você pode redefinir várias propriedades/parâmetros com uma única instrução ALTER; no entanto, cada propriedade/parâmetro deve ser separado por uma vírgula. Além disso, ao reiniciar uma propriedade/parâmetro, você especifica apenas o nome; não é necessário nenhum valor.

Requisitos de controle de acesso¶

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Esses privilégios são exigidos na função primária atualmente ativa, não em uma função secundária.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso¶

• 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.

Exemplos¶

Adicionar manualmente um instantâneo ao conjunto de instantâneos t1_snapshots:

ALTER SNAPSHOT SET t1_snapshots
  ADD SNAPSHOT;

Atualizar a política de instantâneos para conjunto de instantâneos t1_snapshots:

ALTER SNAPSHOT SET t1_snapshots
  APPLY SNAPSHOT POLICY daily_snapshot_policy;

Suspender uma política de instantâneos no conjunto de instantâneos t1_snapshot:

ALTER SNAPSHOT SET t1_snapshots
  SUSPEND SNAPSHOT POLICY;

Retomar uma política de instantâneos no conjunto de instantâneos t1_snapshots:

ALTER SNAPSHOT SET t1_snapshots
  RESUME SNAPSHOT POLICY;

Para encontrar o identificador de instantâneo a ser usado com as cláusulas ADD LEGAL HOLD e REMOVE LEGAL HOLD, você normalmente usa o comando SHOW SNAPSHOTS para listar os instantâneos elegíveis e seus horários de criação. O exemplo a seguir mostra como você pode listar os instantâneos apropriados, adicionar uma retenção legal a um instantâneo específico e, posteriormente, remover essa retenção legal. Substitua seu próprio nome de função, nome do conjunto de instantâneos e identificador de instantâneos.

USE ROLE my_legal_hold_role; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW SNAPSHOTS IN SNAPSHOT SET my_db_snapshot_set
  ->> SELECT "created_on", "snapshot_id" FROM $1 WHERE "is_under_legal_hold" = 'N';
ALTER SNAPSHOT SET my_db_snapshot_set
  MODIFY SNAPSHOT IDENTIFIER '790d1ee4-88b2-451f-9ccc-eacd1e93a134'
  ADD LEGAL HOLD;

USE ROLE my_legal_hold_role; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW SNAPSHOTS IN SNAPSHOT SET my_db_snapshot_set
  ->> SELECT "created_on", "snapshot_id" FROM $1 WHERE "is_under_legal_hold" = 'Y';
ALTER SNAPSHOT SET my_db_snapshot_set
  MODIFY SNAPSHOT IDENTIFIER '790d1ee4-88b2-451f-9ccc-eacd1e93a134'
  REMOVE LEGAL HOLD;