CREATE EXTERNAL SCHEMA

Eine Klausel, die angibt, dass der Befehl keine Änderungen ausführen und die Meldung zurückgeben soll, dass das Schema vorhanden ist, statt mit einem Fehler beendet zu werden, wenn das angegebene Schema bereits vorhanden ist. Diese Klausel ist bei der Skripterstellung nützlich, damit das Skript nicht fehlschlägt, wenn CREATE EXTERNAL SCHEMA versucht wird, ein Schema zu erstellen, das bereits existiert.

Der Name des neuen externen Schemas. Weitere Informationen zu gültigen Namen finden Sie unter Namen und Kennungen.

Ein Schlüsselwort, das angibt, wo sich die externe Datenbank befindet.

DATACATALOGgibt an, dass die externe Datenbank im Athena-Datenkatalog oder im AWS Glue Data Catalog definiert ist.

Wenn die externe Datenbank in einem externen Datenkatalog in einer anderen AWS Region definiert ist, ist der REGION Parameter erforderlich. DATACATALOGist die Standardeinstellung.

HIVEMETASTOREgibt an, dass die externe Datenbank in einem Apache Hive-Metastore definiert ist. Wenn HIVEMETASTORE, angegeben ist, URI ist erforderlich.

POSTGRESgibt an, dass die externe Datenbank in RDS Postgre SQL oder Aurora SQL Postgre definiert ist.

MYSQLgibt an, dass die externe Datenbank in RDS My SQL oder Aurora My definiert istSQL.

KINESISgibt an, dass die Datenquelle ein Stream aus Kinesis Data Streams ist.

MSKgibt an, dass es sich bei der Datenquelle um einen von Amazon MSK bereitgestellten oder serverlosen Cluster handelt.

Ein Schlüsselwort, das angibt, dass sich die Datenbank in Amazon Redshift befindet.

Der Name der Amazon-Redshift-Datenbank.

Der redshift_schema_name gibt das Schema in Amazon Redshift an. Standardmäßig lautet der redshift_schema_name auf public.

Ein Schlüsselwort, das den Namen der externen Datenbank in einer unterstützten Postgre- oder My Database-Engine angibt. SQL SQL

Der schema_name gibt das Schema in einer unterstützten Postgre-Datenbank-Engine an. SQL Der Standard-schema_name ist public.

Sie können a nicht angeben, SCHEMA wenn Sie eine Verbundabfrage für eine unterstützte My Database-Engine einrichten. SQL

Wenn die externe Datenbank in einem Athena-Datenkatalog oder in der AWS Region definiert ist AWS Glue Data Catalog, in der sich die Datenbank befindet. Dieser Parameter ist erforderlich, wenn die Datenbank in einem externen Datenkatalog definiert ist.

Der Hostname und URI die Portnummer einer unterstützten SQL Postgre SQL - oder My-Datenbank-Engine. Der Hostname ist der Haarknoten des Replikatsatzes. Der Endpunkt muss vom Amazon-Redshift-Cluster aus erreichbar (routingfähig) sein. Die standardmäßige Postgre-Portnummer ist 5432SQL. Die Standardeinstellung Meine Portnummer ist 3306SQL.

Einen Hive-Metastore angeben URI

Wenn sich die Datenbank in einem Hive-Metastore befindet, geben Sie die URI und optional die Portnummer für den Metastore an. Die Standard-Portnummer ist 9083.

A enthält URI keine Protokollspezifikation („http://“). Ein gültiges BeispielURI:uri '172.10.10.10'.

Angabe eines Brokers URI für die Streaming-Aufnahme

Die Einbindung des Bootstrap-Brokers URI bietet die Möglichkeit, eine Verbindung zu einem MSK Amazon-Cluster herzustellen und gestreamte Daten zu empfangen. Weitere Informationen und ein Beispiel finden Sie unter Erste Schritte mit der Streaming-Aufnahme von Amazon Managed Streaming for Apache Kafka.

Verwenden Sie das Schlüsselwort default, damit Amazon Redshift die IAM Rolle verwendet, die als Standard festgelegt und dem Cluster zugeordnet ist, wenn der CREATE EXTERNAL SCHEMA Befehl ausgeführt wird.

Verwenden Sie 'SESSION', wenn Sie über eine Verbundidentität eine Verbindung zu Ihrem Amazon-Redshift-Cluster herstellen und über das mit diesem Befehl erstellte externe Schema auf die Tabellen zugreifen. Weitere Informationen finden Sie unter Verwenden einer Verbundidentität zur Verwaltung des Amazon-Redshift-Zugriffs auf lokale Ressourcen und externe Amazon-Redshift-Spectrum-Tabellen. Darin wird erläutert, wie Sie eine Verbundidentität konfigurieren. Beachten Sie, dass diese Konfiguration, die anstelle von verwendet wirdARN, nur verwendet werden kann, wenn das Schema mit DATA CATALOG erstellt wurde. 'SESSION'

Verwenden Sie den Amazon-Ressourcennamen (ARN) für eine IAM Rolle, die Ihr Cluster für die Authentifizierung und Autorisierung verwendet. Die IAM Rolle muss mindestens über die Berechtigung verfügen, einen LIST Vorgang auf dem Amazon S3 S3-Bucket auszuführen, auf den zugegriffen werden soll, und einen GET Vorgang auf den Amazon S3 S3-Objekten, die der Bucket enthält.

Im Folgenden wird die Syntax für die Zeichenfolge mit dem ROLE Parameter IAM _ für eine einzelne Zeichenfolge dargestelltARN.

IAM_ROLE 'arn:aws:iam::<aws-account-id>:role/<role-name>'

Sie können Rollen verketten, sodass Ihr Cluster eine andere IAM Rolle übernehmen kann, die möglicherweise zu einem anderen Konto gehört. Es können bis zu 10 Rollen miteinander verkettet werden. Ein Beispiel für die Verkettung von Rollen finden Sie unter Verkettung von IAM Rollen in Amazon Redshift Spectrum.

Fügen Sie dieser IAM Rolle eine IAM Berechtigungsrichtlinie hinzu, die der folgenden ähnelt.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AccessSecret",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetResourcePolicy",
                "secretsmanager:GetSecretValue",
                "secretsmanager:DescribeSecret",
                "secretsmanager:ListSecretVersionIds"
            ],
            "Resource": "arn:aws:secretsmanager:us-west-2:123456789012:secret:my-rds-secret-VNenFy"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetRandomPassword",
                "secretsmanager:ListSecrets"
            ],
            "Resource": "*"
        }
    ]
}

Die Schritte zum Erstellen einer IAM Rolle zur Verwendung mit Verbundabfragen finden Sie unterErstellen Sie ein Geheimnis und eine IAM Rolle für die Verwendung verbundener Abfragen.

Nachfolgend finden Sie die Syntax für die Verkettung von drei Rollen.

IAM_ROLE 'arn:aws:iam::<aws-account-id>:role/<role-1-name>,arn:aws:iam::<aws-account-id>:role/<role-2-name>,arn:aws:iam::<aws-account-id>:role/<role-3-name>'

Der Amazon-Ressourcenname (ARN) eines unterstützten Postgre SQL - oder My SQL Database-Engine-Geheimnisses, das mit AWS Secrets Manager erstellt wurde. Informationen zum Erstellen und Abrufen eines ARN geheimen Geheimnisses finden Sie unter Creating a Basic Secret und Retrieving the Secret Value Secret im AWS Secrets Manager Benutzerhandbuch.

Verwenden Sie 'SESSION', um mithilfe einer Verbundidentität eine Verbindung mit Ihrem Amazon-Redshift-Cluster herzustellen, um den Datenkatalog zu authentifizieren und zu autorisieren. Weitere Informationen zur Durchführung der Schritte für eine Verbundidentität finden Sie unter Verwenden einer Verbundidentität zur Verwaltung des Amazon-Redshift-Zugriffs auf lokale Ressourcen und externe Amazon-Redshift-Spectrum-Tabellen. Beachten Sie, dass die 'SESSION' Rolle nur verwendet werden kann, wenn das Schema in DATA CATALOG erstellt wurde.

Verwenden Sie den Amazon-Ressourcennamen ARN für eine IAM Rolle, die Ihr Cluster für die Authentifizierung und Autorisierung für den Datenkatalog verwendet.

Wenn CATALOG _ ROLE nicht angegeben ist, verwendet Amazon Redshift das angegebene IAM _ROLE. Die Katalogrolle muss über die Berechtigung verfügen, auf den Datenkatalog in AWS Glue oder Athena zuzugreifen. Weitere Informationen finden Sie unter IAMRichtlinien für Amazon Redshift Spectrum.

Im Folgenden wird die Syntax für die ROLE Parameterzeichenfolge CATALOG _ für eine einzelne ARN Zeichenfolge dargestellt.

CATALOG_ROLE 'arn:aws:iam::<aws-account-id>:role/<catalog-role>'

Sie können Rollen verketten, sodass Ihr Cluster eine andere IAM Rolle übernehmen kann, die möglicherweise zu einem anderen Konto gehört. Es können bis zu 10 Rollen miteinander verkettet werden. Weitere Informationen finden Sie unter Verkettung von IAM Rollen in Amazon Redshift Spectrum.

Nachfolgend finden Sie die Syntax für die Verkettung von drei Rollen.

CATALOG_ROLE 'arn:aws:iam::<aws-account-id>:role/<catalog-role-1-name>,arn:aws:iam::<aws-account-id>:role/<catalog-role-2-name>,arn:aws:iam::<aws-account-id>:role/<catalog-role-3-name>'

Eine Klausel, die eine externe Datenbank mit dem durch das DATABASE Argument angegebenen Namen erstellt, wenn die angegebene externe Datenbank nicht existiert. Wenn die angegebene externe Datenbank vorhanden ist, führt der Befehl keine Änderungen aus. In diesem Fall gibt der Befehl die Meldung zurück, dass die externe Datenbank vorhanden ist, statt mit einem Fehler beendet zu werden.

Die Konto-ID, in der die Datenkatalogdatenbank gespeichert ist.

CATALOG_ID kann nur angegeben werden, wenn Sie planen, für die Authentifizierung und Autorisierung beim Datenkatalog mithilfe einer Verbundidentität eine Verbindung mit Ihrem Amazon-Redshift-Cluster oder Amazon Redshift Serverless herzustellen, indem Sie eine der folgenden Einstellungen festlegen:

Weitere Informationen zur Durchführung der Schritte für Verbundidentität finden Sie unter Verwenden einer Verbundidentität zur Verwaltung des Amazon-Redshift-Zugriffs auf lokale Ressourcen und externe Amazon-Redshift-Spectrum-Tabellen

Der für die Streaming-Erfassung definierte Authentifizierungstyp. Die Streaming-Erfassung mit Authentifizierungstypen kann mit Amazon Managed Streaming for Apache Kafka verwendet werden. Es stehen folgende AUTHENTICATION-Typen zur Verfügung:

Das AWS Certificate Manager Zertifikat, das ARN von Amazon Redshift für die MTLS-Authentifizierung bei Amazon verwendet wird. MSK Das ARN ist in der ACM Konsole verfügbar, wenn Sie das ausgestellte Zertifikat auswählen.

Für die Streaming-Aufnahme ARN ist CLUSTER _ die Cluster-ID für den Amazon Managed Streaming for Apache Kafka Kafka-Cluster, von dem Sie streamen. Wenn Sie CLUSTER _ verwendenARN, ist eine IAM Rollenrichtlinie erforderlich, die die Berechtigung beinhaltet. kafka:GetBootstrapBrokers Diese Option wird aus Gründen der Abwärtskompatibilität bereitgestellt. Derzeit empfehlen wir, die URI Bootstrap-Broker-Option zu verwenden, um eine Verbindung zu Amazon Managed Streaming for Apache Kafka Kafka-Cluster herzustellen. Weitere Informationen finden Sie unter Streaming-Erfassung.