VORLAGE ERSTELLEN - Amazon Redshift
Erforderliche BerechtigungenSyntaxParametersBeispiele

Amazon Redshift unterstützt UDFs ab Patch 198 nicht mehr die Erstellung von neuem Python. Das bestehende Python UDFs wird bis zum 30. Juni 2026 weiterhin funktionieren. Weitere Informationen finden Sie im Blog-Posting.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

VORLAGE ERSTELLEN

Erstellt wiederverwendbare Vorlagen für Amazon Redshift Redshift-Befehle wieCOPY. Vorlagen speichern häufig verwendete Parameter, auf die bei mehreren Befehlsausführungen verwiesen werden kann, wodurch die Konsistenz verbessert und die manuelle Parameterspezifikation reduziert wird.

Vorlagen machen es überflüssig, dieselben Formatierungsparameter für mehrere Operationen wiederholt anzugeben, während Quellpfade, Zieltabellen und Autorisierung von Vorgang zu Vorgang variieren können.

Erforderliche Berechtigungen

Um eine Vorlage zu erstellen, benötigen Sie eine der folgenden Voraussetzungen:

  • Superuser-Rechte

  • CREATE-Berechtigung für das Schema, in dem Sie die Vorlage erstellen möchten, oder CREATE-Bereichsberechtigung für Schemas in der Datenbank, in der Sie die Vorlage erstellen möchten

Syntax

CREATE [ OR REPLACE ] TEMPLATE [database_name.][schema_name.]template_name
FOR COPY [ AS ]
[ [ FORMAT ] [ AS ] data_format ]
[ parameter [ argument ] [ , ... ] ];

Parameters

ODER ERSETZEN

Wenn in der angegebenen Datenbank und dem angegebenen Schema bereits eine Vorlage mit demselben Namen vorhanden ist, wird die vorhandene Vorlage ersetzt. Sie können eine Vorlage nur durch eine neue Vorlage ersetzen, die denselben Operationstyp definiert, beispielsweise COPY. Sie müssen über die erforderlichen Rechte verfügen, um eine Vorlage zu ersetzen.

database_name

(Optional) Der Name der Datenbank, in der die Vorlage erstellt wird. Wenn nicht angegeben, wird die Vorlage in der aktuellen Datenbank erstellt.

Wenn die Datenbank oder das Schema nicht existiert, wird die Vorlage nicht erstellt und die Anweisung gibt einen Fehler zurück. Sie können keine Vorlagen in den Systemdatenbankentemplate0, template1padb_harvest, oder erstellensys:internal.

schema_name

(Optional) Der Name des Schemas, in dem die Vorlage erstellt wird. Wenn nicht angegeben, wird die Vorlage im aktuellen Schema erstellt.

Wenn ein Schemaname angegeben wird, wird die neue Vorlage in diesem Schema erstellt (vorausgesetzt, der Ersteller hat Zugriff auf das Schema). Der Vorlagenname muss ein eindeutiger Name für dieses Schema sein.

Vorlagenname

Der Name der zu erstellenden Vorlage. Optional kann der Vorlagenname mit dem Datenbank- und Schemanamen qualifiziert werden. Im folgenden Beispiel lautet der Datenbanknamedemo_database, der Schemaname ist demo_schema und der Vorlagenname isttest. Weitere Informationen zu gültigen Namen finden Sie unter Namen und Kennungen.

CREATE TEMPLATE demo_database.demo_schema.test FOR COPY AS CSV;
COPY

Gibt den Redshift-Befehlstyp an, für den die Vorlage erstellt wird. Derzeit wird nur der Befehl COPY unterstützt.

[[FORMAT] [AS] Datenformat]

Dieser Parameter ist optional. Dies spezifiziert das Datenformat für COPY-Operationen.

[Parameter [Argument]]

Jeder gültige Parameter für den angegebenen Redshift-Befehl.

Vorlagen für den Befehl COPY können beispielsweise Folgendes beinhalten:

Eine vollständige Liste der unterstützten Parameter finden Sie unter COPY Befehl.

Nutzungshinweise

  • Standardmäßig besitzen alle Benutzer CREATE- und USAGE-Rechte für das Schema PUBLIC. Um Benutzer daran zu hindern, Objekte im Schema PUBLIC einer Datenbank zu erstellen, verwenden Sie den Befehl REVOKE, um dieses Recht zu entfernen.

  • Wenn ein Parameter sowohl in der Vorlage als auch im Befehl vorhanden ist, hat der Befehlsparameter Vorrang.

  • Vorlagen sind Datenbankobjekte und folgen den standardmäßigen Redshift-Objektbenennungs- und Berechtigungsregeln. Weitere Informationen zu gültigen Namen finden Sie unter Namen und Kennungen.

  • Vorlagen dürfen keine Manifestdateispezifikationen für COPY Befehle enthalten.

Einschränkungen

  • Beim Erstellen einer Vorlage muss mindestens ein Parameter angegeben werden.

  • Ausgeschlossene Parameter — Befehlsspezifische Parameter wie Quellpfade, Zieltabellen, Autorisierungsdaten und Manifestdateispezifikationen können nicht in Vorlagen enthalten sein. Diese Parameter müssen im eigentlichen Befehl angegeben werden.

  • Maximale Anzahl an Vorlagen pro Cluster — Sie können maximal 1.000 Vorlagen pro Cluster erstellen. Dieses Limit gilt für die Gesamtzahl der Vorlagen in allen Datenbanken und Schemas im Cluster.

  • Datenbankübergreifende Verweise — Vorlagen können nicht datenbankübergreifend referenziert werden.

  • Gemeinsame Nutzung von Daten — Vorlagen können nicht in Datenfreigaben enthalten sein. Vorlagen müssen in jedem Cluster, in dem sie benötigt werden, separat erstellt werden.

Beispiele

Im folgenden Beispiel wird eine Vorlage für den Befehl COPY erstellt 

CREATE TEMPLATE test_schema.demo_template
FOR COPY
AS
FORMAT JSON 'auto'
NULL AS ''
MAXERROR 100;

Verwenden SieVORLAGE ANZEIGEN, um die Definition der Vorlage abzurufen:


SHOW TEMPLATE test_schema.demo_template;
CREATE OR REPLACE TEMPLATE dev.test_schema.demo_template FOR COPY AS FORMAT AS JSON 'auto' NULL '' MAXERROR 100;

Fragen Sie die SYS_REDSHIFT_TEMPLATE Systemansicht ab, um weitere Informationen zu einer Vorlage zu erhalten. 

SELECT * FROM SYS_REDSHIFT_TEMPLATE;

database_name | schema_name | template_name | template_type |        create_time         |     last_modified_time     | owner_id | last_modified_by | template_parameters 
---------------+-------------+---------------+---------------+----------------------------+----------------------------+----------+------------------+---------------------
 dev           | test_schema | demo_template |             1 | 2025-12-17 20:06:01.944171 | 2025-12-17 20:06:01.944171 |        1 |                1 | {
    "JSON": "auto",
    "MAXERROR": 100,
    "NULL": ""
}