ALTER MODEL

Ändert die Eigenschaften eines vorhandenen Modells, einschließlich Name, Tags, Standardversion oder Kommentar.

Es gibt drei weitere Varianten dieses Befehls:

Syntax

ALTER MODEL [ IF EXISTS ] <name> SET
  [ COMMENT = '<string_literal>' ]
  [ DEFAULT_VERSION = '<version_name>']

ALTER MODEL [ IF EXISTS ] <model_name> SET TAG <tag_name> = '<tag_value>'

ALTER MODEL [ IF EXISTS ] <model_name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER MODEL [ IF EXISTS ] <model_name> VERSION <version_name> SET ALIAS = '<alias_name>'

ALTER MODEL [ IF EXISTS ] <model_name> VERSION <version_or_alias_name> UNSET ALIAS

ALTER MODEL <model_name> RENAME TO <new_name>
Copy

Parameter

name

Gibt den Bezeichner (d. h. den Namen) des Modells 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.

SET ...

Gibt eine oder mehrere Modelleigenschaften an, die festgelegt werden sollen.

COMMENT = 'string_literal'

Legt den Kommentar zum Modell fest. Dies kann auch mit dem Befehl COMMENT erfolgen.

DEFAULT_VERSION = 'version_name'

Legt die Standardversion des Modells fest (die Version, mit der Methoden aufgerufen werden, wenn eine Methode direkt im Modell aufgerufen wird). Der Versionsname ist ein Bezeichner.

Der Systemalias DEFAULT verweist auf die Standardversion.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Gibt den Namen des Tags und den Wert der Tag-Zeichenfolge an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

Weitere Informationen zur Angabe von Tags in einer Anweisung finden Sie unter Tag-Kontingente für Objekte und Spalten.

ALIAS = 'alias_name'

Legt alias_name als Alias der Version fest. Ein Alias ist ein alternativer Name, der leicht neu zugewiesen werden kann. Der Alias kann an den meisten Stellen verwendet werden, an denen auch der Versionsname verwendet werden kann. Eine Version kann höchstens einen Alias haben.

Der Aliasname ist ein Bezeichner. Er muss im Modell eindeutig sein und darf die folgenden System-Aliasnamen nicht duplizieren:

  • DEFAULT bezieht sich auf die Standardversion des Modells.

  • FIRST bezieht sich auf die älteste Version des Modells gemäß Erstellungszeitpunkt.

  • LAST bezieht sich auf die neueste Version des Modells gemäß Erstellungszeitpunkt.

UNSET TAG tag_name [ , tag_name ... ]

Gibt ein oder mehrere Tags an, die aus dem Modell entfernt werden sollen.

UNSET ALIAS

Entfernt den Alias von dieser Modellversion, falls vorhanden. Die System-Aliasse DEFAULT, FIRST und LAST können nicht entfernt werden. Sie können die Version durch ihren Namen oder durch einen Alias angeben.

RENAME TO new_name

Benennt das angegebene Modell mit einem neuen Bezeichner um, der derzeit von keinem anderen Modell im Schema verwendet wird.

Weitere Informationen zu Bezeichnern finden Sie unter Anforderungen an Bezeichner.

Sie können das Objekt in eine andere Datenbank und/oder in ein anderes Schema verschieben und dabei optional das Objekt umbenennen. Geben Sie dazu einen qualifizierten new_name-Wert an, der den neuen Datenbank- und/oder Schemanamen im Format db_name.schema_name.object_name bzw. schema_name.object_name enthält.

Bemerkung

  • Die Zieldatenbank und/oder das Zielschema müssen bereits vorhanden sein. Außerdem darf in der Zieldatenbank nicht bereits ein gleichnamiges Schema vorhanden sein, da die Anweisung sonst einen Fehler zurückgibt.

  • Das Verschieben eines Objekts in ein verwaltetes Zugriffsschema ist nicht zulässig, es sei denn, der Objekteigentümer (d. h. die Rolle mit der Berechtigung OWNERSHIP für das Objekt) ist auch Eigentümer des Zielschemas.

Wenn ein Modell umbenannt wird, müssen andere Objekte, die darauf verweisen, mit dem neuen Namen aktualisiert werden.

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung

Objekt

Anmerkungen

OWNERSHIP

Modell

Um ein temporäres Objekt zu erstellen, das denselben Namen hat wie das bereits im Schema vorhandene Objekt, muss der verwendeten Rolle die Berechtigung OWNERSHIP für das Objekt erteilt worden sein oder die Rolle muss diese Berechtigung geerbt haben.

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

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.

Sprache: Deutsch