DROP-AGENT¶

Entfernt den angegebenen Cortex Agent mit dem angegebenen Namen aus der aktuellen oder der angegebenen Datenbank und dem Schema.

Siehe auch:: CREATE-AGENT, DESCRIBE-AGENT, SHOW-AGENTS

Syntax¶

DROP AGENT [ IF EXISTS ] <name>

Copy

Parameter¶

name

Gibt den Bezeichner für den zu löschenden Cortex Agent an.

Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung	Objekt	Anmerkungen
OWNERSHIP	Agent
MODIFY	Agent

USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen. Beachten Sie, dass eine Rolle, die eine beliebige Berechtigung für ein Schema erhalten hat, es dieser Rolle erlaubt, das Schema aufzulösen. Zum Beispiel kann eine Rolle, der die CREATE-Berechtigung für ein Schema gewährt wurde, Objekte in diesem Schema erstellen, ohne auch USAGE für dieses Schema gewährt bekommen zu haben.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise¶

Wenn die IF EXISTS-Klausel angegeben ist und das Zielobjekt nicht vorhanden ist, wird der Befehl erfolgreich abgeschlossen, ohne dass ein Fehler zurückgegeben wird.

Beispiele¶

Im folgenden Beispiel wird der Agent namens my_agent im aktuellen Schema gelöscht:

DROP AGENT my_agent;

Copy

Im folgenden Beispiel wird der Agent namens my_agent in der mydb-Datenbank und im myschema-Schema gelöscht. Dieser Befehl schlägt fehl, wenn der Agent nicht existiert:

DROP AGENT mydb.myschema.my_agent;

Copy

Im folgenden Beispiel wird der Agent namens my_agent in der mydb-Datenbank und im myschema Schema nur gelöscht, wenn es existiert:

DROP AGENT IF EXISTS mydb.myschema.my_agent;

Copy