DROP AGENT¶

Sintaxe¶

DROP AGENT [ IF EXISTS ] <name>

Parâmetros¶

name

Especifica o identificador para o Cortex Agent 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:

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema. Observe que uma função com privilégio concedido em um esquema permite que essa função resolva o esquema. Por exemplo, uma função com privilégio CREATE concedido em um esquema pode criar objetos nesse esquema sem também ter USAGE concedido nesse esquema.

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 agente denominado my_agent no esquema atual:

DROP AGENT my_agent;

O exemplo a seguir descarta o agente denominado my_agent no mydb banco de dados e myschema esquema. Esse comando falhará se o agente não existir:

DROP AGENT mydb.myschema.my_agent;

O exemplo a seguir descarta o agente denominado my_agent no mydb banco de dados e myschema esquema somente se ele existir:

DROP AGENT IF EXISTS mydb.myschema.my_agent;