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:

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

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;