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.

The FORCE option overwrites an existing policy on a snapshot set. You can only use this option if the old policy doesn’t have a retention lock.

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

Suspend a snapshot policy in the snapshot set. You can suspend the entire snapshot policy, or only creation or expiration operations. When you specify SUSPEND SNAPSHOT POLICY without the CREATION or EXPIRATION keywords, Snowflake suspends both the creation and expiration aspects of the policy. For more information, see Suspend a backup policy on a backup set.

RESUME SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

Resume a suspended snapshot policy in the set. You can resume the entire snapshot policy, or only creation or expiration operations. When you specify RESUME SNAPSHOT POLICY without the CREATION or EXPIRATION keywords, Snowflake resumes both the creation and expiration aspects of the policy. For more information, see Resume a backup policy on a backup set.

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 Delete a backup from a backup set.

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 Legal hold. Para exemplos de uso desta cláusula, consulte Add and remove legal holds.

SET COMMENT = 'string_literal'

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

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

Specifies the tag name and the tag string value.

The tag value is always a string, and the maximum number of characters for the tag value is 256.

For information about specifying tags in a statement, see Tag quotas.

UNSET ...

Specifies one (or more) properties and/or parameters to unset for the snapshot set, which resets them to the defaults:

• property_name

• param_name

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

You can reset multiple properties/parameters with a single ALTER statement; however, each property/parameter must be separated by a comma. Also, when resetting a property/parameter, you only specify the name; no value is required.

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;