DROP-AGENT¶

Syntax¶

DROP AGENT [ IF EXISTS ] <name>

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:

Für das Ausführen von Operationen für ein Objekt in einem Schema ist mindestens eine Berechtigung für die übergeordnete Datenbank und mindestens eine Berechtigung für das übergeordnete Schema erforderlich.

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;

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;

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;