DROP POSTGRES INSTANCE¶

Sintaxe¶

DROP POSTGRES INSTANCE [ IF EXISTS ] <name>

Parâmetros¶

name

Especifica o identificador da instância Postgres a ser descartada.

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.

Requisitos de controle de acesso¶

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

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¶

• Atualmente, as instâncias Postgres descartadas não podem ser recuperadas. Você deve recriá-las. Entretanto, se você criou uma bifurcação da instância, a bifurcação permanece independente e não afetada. Para facilitar a recriação de instâncias no futuro, você pode usar DESC POSTGRES INSTANCE para capturar os detalhes de cada instância antes de descartá-la.

• Quando esse comando é emitido, o Snowflake encerra a instância do Postgres e libera os recursos de computação associados. O faturamento dos recursos de computação é interrompido depois que a instância é totalmente encerrada.

• Todos os dados armazenados na instância do Postgres são excluídos permanentemente. Certifique-se de ter feito backup de todos os dados importantes antes de descartar a instância.

• Se a instância tem a alta disponibilidade habilitada, a HA de espera também é descartada junto com a instância primária.

• Se a instância tem réplicas de leitura, essas réplicas também são descartadas quando a instância primária é descartada.

• Instâncias bifurcadas são cópias independentes. O descarte da instância de origem não afeta as instâncias que foram bifurcadas a partir dela.

• Quando a cláusula IF EXISTS é especificada e o objeto de destino não existe, o comando é concluído com sucesso sem retornar um erro.

Exemplos¶

Descartar uma instância do Postgres:

DROP POSTGRES INSTANCE my_postgres;

Descartar uma instância do Postgres somente se ela existir:

DROP POSTGRES INSTANCE IF EXISTS my_postgres;

Use o operador de fluxo para encontrar uma instância a ser descartada:

-- Find the oldest instance
-- Then use SET and IDENTIFIER() to drop it
SET oldest_instance = (
  SHOW POSTGRES INSTANCES
    ->> SELECT "name"
        FROM $1
        ORDER BY "created_on"
        LIMIT 1
);

DROP POSTGRES INSTANCE IDENTIFIER($oldest_instance);

Encontre instâncias abaixo de um limite de armazenamento antes de descartar:

-- Identify small instances
SHOW POSTGRES INSTANCES
  ->> SELECT "name", "storage_size", "created_on"
      FROM $1
      WHERE "storage_size" < 50
      ORDER BY "storage_size";

DROP some_extremely_small_instance;

Verifique a propriedade antes de tentar descartar:

SHOW GRANTS ON POSTGRES INSTANCE my_postgres;

-- Verify that you have OWNERSHIP privilege, then drop
DROP POSTGRES INSTANCE my_postgres;