DROP GATEWAY¶

Remove o gateway especificado do esquema atual ou determinado.

Consulte também:: CREATE GATEWAY, ALTER GATEWAY, SHOW GATEWAYS, DESCRIBE GATEWAY

Sintaxe¶

DROP GATEWAY [ IF EXISTS ] <name>

Copy

Parâmetros obrigatórios¶

name

Especifica o identificador do gateway a ser descartado.

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:

Privilégio	Objeto	Notas
OWNERSHIP	Gateway	Necessário para descartar o gateway.

Operar em um objeto em um esquema requer pelo menos um privilégio no banco de dados pai e pelo menos um privilégio no esquema pai.

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¶

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¶

O exemplo a seguir descarta o gateway chamado split_gateway:

DROP GATEWAY split_gateway;

Copy

+-------------------------------------+
| status                              |
|-------------------------------------|
| SPLIT_GATEWAY successfully dropped. |
+-------------------------------------+