AWS Glue REST APIs für Apache Iceberg-Spezifikationen

Fokusmodus

AWS Glue REST APIs für Apache Iceberg-Spezifikationen - AWS Glue

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.

Dieser Abschnitt enthält Spezifikationen zum AWS Glue Iceberg-REST-Katalog und zur AWS Glue REST-Erweiterung APIs sowie Überlegungen zu deren Verwendung. APIs

API-Anfragen an die AWS Glue Data Catalog Endgeräte werden mit AWS Signature Version 4 (Sigv4) authentifiziert. Weitere Informationen zu AWS Sigv4 finden Sie im Abschnitt Signature Version 4 für API-Anfragen. AWS

Beim Zugriff auf den AWS Glue Dienstendpunkt und die AWS Glue Metadaten nimmt die Anwendung eine IAM-Rolle ein, für die eine IAM-Aktion erforderlich istglue:getCatalog.

Der Zugriff auf den Datenkatalog und seine Objekte kann mithilfe von IAM-, Lake Formation- oder Lake Formation Formation-Hybridmodus-Berechtigungen verwaltet werden.

Verbundkataloge im Datenkatalog haben in Lake Formation registrierte Datenspeicherorte. Lake Formation arbeitet mit dem Datenkatalog zusammen, um Datenbankberechtigungen zur Verwaltung des Benutzerzugriffs auf Datenkatalogobjekte bereitzustellen.

Sie können IAM- oder Lake Formation Formation-Hybridmodus-Berechtigungen verwenden AWS Lake Formation, um den Zugriff auf den Standard-Datenkatalog und seine Objekte zu verwalten.

Um Daten in verwalteten Objekten von Lake Formation zu erstellen, einzufügen oder zu löschen, müssen Sie spezifische Berechtigungen für den IAM-Benutzer oder die IAM-Rolle einrichten.

CREATE_CATALOG — Erforderlich, um Kataloge zu erstellen
CREATE_DATABASE — Erforderlich, um Datenbanken zu erstellen
CREATE_TABLE — Erforderlich, um Tabellen zu erstellen
DELETE — Erforderlich, um Daten aus einer Tabelle zu löschen
DESCRIBE — Erforderlich, um Metadaten zu lesen
DROP — Erforderlich, um eine Tabelle oder Datenbank zu löschen/zu löschen
INSERT — Wird benötigt, wenn der Principal Daten in eine Tabelle einfügen muss
SELECT — Wird benötigt, wenn der Principal Daten aus einer Tabelle auswählen muss

Weitere Informationen finden Sie in der Berechtigungsreferenz für Lake Formation im AWS Lake Formation Entwicklerhandbuch.

Allgemeine Informationen
Name der Operation	GetConfig
Typ	Iceberg REST-Katalog-API
REST-Pfad	GET /iceberg/v1/config
IAM-Aktion	kleben: GetCatalog
Genehmigungen für Lake Formation	Nicht zutreffend
CloudTrail event	Klebstoff: GetCatalog
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L67

Überlegungen und Einschränkungen

Der warehouse Abfrageparameter muss auf die AWS Glue Katalog-ID festgelegt werden. Wenn nicht festgelegt, wird der Stammkatalog im aktuellen Konto verwendet, um die Antwort zurückzugeben. Weitere Informationen finden Sie unter Parameter für Präfix und Katalogpfad.

GetConfig

Allgemeine Informationen
Name der Operation	GetConfig
Typ	Iceberg REST-Katalog-API
REST-Pfad	GET /iceberg/v1/config
IAM-Aktion	kleben: GetCatalog
Genehmigungen für Lake Formation	Nicht zutreffend
CloudTrail event	Klebstoff: GetCatalog
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L67

Überlegungen und Einschränkungen

Der warehouse Abfrageparameter muss auf die AWS Glue Katalog-ID festgelegt werden. Wenn nicht festgelegt, wird der Stammkatalog im aktuellen Konto verwendet, um die Antwort zurückzugeben. Weitere Informationen finden Sie unter Parameter für Präfix und Katalogpfad.

Allgemeine Informationen
Name der Operation	GetCatalog
Typ	AWS Glue Erweiterungs-API
REST-Pfad	GET/extensions/v1/catalogs/{Katalog}
IAM-Aktion	Klebstoff: GetCatalog
Genehmigungen für Lake Formation	DESCRIBE
CloudTrail event	Klebstoff: GetCatalog
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L40

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.

GetCatalog

Allgemeine Informationen
Name der Operation	GetCatalog
Typ	AWS Glue Erweiterungs-API
REST-Pfad	GET/extensions/v1/catalogs/{Katalog}
IAM-Aktion	Klebstoff: GetCatalog
Genehmigungen für Lake Formation	DESCRIBE
CloudTrail event	Klebstoff: GetCatalog
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L40

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.

Allgemeine Informationen
Name der Operation	ListNamespaces
Typ	Iceberg REST-Katalog-API
REST-Pfad	GET/iceberg/v1/catalogs/{catalog}/namespaces
IAM-Aktion	kleben: GetDatabase
Genehmigungen für Lake Formation	ALLES, BESCHREIBE, WÄHLE
CloudTrail event	kleben: GetDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L205

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Es werden nur Namespaces der nächsten Ebene angezeigt. Um Namespaces auf tieferen Ebenen aufzulisten, geben Sie die ID des verschachtelten Katalogs im Katalogpfadparameter an.

ListNamespaces

Allgemeine Informationen
Name der Operation	ListNamespaces
Typ	Iceberg REST-Katalog-API
REST-Pfad	GET/iceberg/v1/catalogs/{catalog}/namespaces
IAM-Aktion	kleben: GetDatabase
Genehmigungen für Lake Formation	ALLES, BESCHREIBE, WÄHLE
CloudTrail event	kleben: GetDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L205

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Es werden nur Namespaces der nächsten Ebene angezeigt. Um Namespaces auf tieferen Ebenen aufzulisten, geben Sie die ID des verschachtelten Katalogs im Katalogpfadparameter an.

Allgemeine Informationen
Name der Operation	CreateNamespace
Typ	Iceberg REST-Katalog-API
REST-Pfad	POST/iceberg/v1/catalogs/{catalog}/namespaces
IAM-Aktion	kleben: CreateDatabase
Genehmigungen für Lake Formation	ALLES, BESCHREIBE, WÄHLE
CloudTrail event	kleben: CreateDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L256

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Es kann nur ein Namespace mit einer Ebene erstellt werden. Um einen Namespace mit mehreren Ebenen zu erstellen, müssen Sie jede Ebene iterativ erstellen und mithilfe des Katalogpfadparameters eine Verbindung zu der Ebene herstellen.

CreateNamespace

Allgemeine Informationen
Name der Operation	CreateNamespace
Typ	Iceberg REST-Katalog-API
REST-Pfad	POST/iceberg/v1/catalogs/{catalog}/namespaces
IAM-Aktion	kleben: CreateDatabase
Genehmigungen für Lake Formation	ALLES, BESCHREIBE, WÄHLE
CloudTrail event	kleben: CreateDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L256

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Es kann nur ein Namespace mit einer Ebene erstellt werden. Um einen Namespace mit mehreren Ebenen zu erstellen, müssen Sie jede Ebene iterativ erstellen und mithilfe des Katalogpfadparameters eine Verbindung zu der Ebene herstellen.

Allgemeine Informationen
Name der Operation	StartCreateNamespaceTransaction
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST/extensions/v1/catalogs/{catalog}/namespaces
IAM-Aktion	kleben: CreateDatabase
Genehmigungen für Lake Formation	ALLES, BESCHREIBE, WÄHLE
CloudTrail event	kleben: CreateDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L256

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können nur einen Namespace mit einer Ebene erstellen. Um Namespaces mit mehreren Ebenen zu erstellen, müssen Sie jede Ebene iterativ erstellen und mithilfe des Katalogpfadparameters eine Verbindung zu der Ebene herstellen.
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie für die Nachverfolgung mithilfe des API-Aufrufs verwenden können. CheckTransactionStatus
Sie können diese API nur aufrufen, wenn der GetCatalog API-Aufruf den Parameter use-extensions=true in der Antwort enthält.

StartCreateNamespaceTransaction

Allgemeine Informationen
Name der Operation	StartCreateNamespaceTransaction
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST/extensions/v1/catalogs/{catalog}/namespaces
IAM-Aktion	kleben: CreateDatabase
Genehmigungen für Lake Formation	ALLES, BESCHREIBE, WÄHLE
CloudTrail event	kleben: CreateDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L256

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können nur einen Namespace mit einer Ebene erstellen. Um Namespaces mit mehreren Ebenen zu erstellen, müssen Sie jede Ebene iterativ erstellen und mithilfe des Katalogpfadparameters eine Verbindung zu der Ebene herstellen.
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie für die Nachverfolgung mithilfe des API-Aufrufs verwenden können. CheckTransactionStatus
Sie können diese API nur aufrufen, wenn der GetCatalog API-Aufruf den Parameter use-extensions=true in der Antwort enthält.

Allgemeine Informationen
Name des Vorgangs	LoadNamespaceMetadata
Typ	Iceberg REST-Katalog-API
REST-Pfad	GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns}
IAM-Aktion	kleben: GetDatabase
Genehmigungen für Lake Formation	ALLES, BESCHREIBE, WÄHLE
CloudTrail event	kleben: GetDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L302

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.

LoadNamespaceMetadata

Allgemeine Informationen
Name des Vorgangs	LoadNamespaceMetadata
Typ	Iceberg REST-Katalog-API
REST-Pfad	GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns}
IAM-Aktion	kleben: GetDatabase
Genehmigungen für Lake Formation	ALLES, BESCHREIBE, WÄHLE
CloudTrail event	kleben: GetDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L302

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.

Allgemeine Informationen
Name des Vorgangs	UpdateNamespaceProperties
Typ	Iceberg REST-Katalog-API
REST-Pfad	POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties
IAM-Aktion	kleben: UpdateDatabase
Genehmigungen für Lake Formation	RUF AN, SPÄTER
CloudTrail event	kleben: UpdateDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L400

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.

UpdateNamespaceProperties

Allgemeine Informationen
Name des Vorgangs	UpdateNamespaceProperties
Typ	Iceberg REST-Katalog-API
REST-Pfad	POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties
IAM-Aktion	kleben: UpdateDatabase
Genehmigungen für Lake Formation	RUF AN, SPÄTER
CloudTrail event	kleben: UpdateDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L400

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.

Allgemeine Informationen
Name der Operation	DeleteNamespace
Typ	Iceberg REST-Katalog-API
REST-Pfad	DELETE/iceberg/v1/catalogs/{catalog}/namespces/{ns}
IAM-Aktion	kleben: DeleteDatabase
Genehmigungen für Lake Formation	ALLES, FALLENLASSEN
CloudTrail event	kleben: DeleteDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L365

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Wenn sich Objekte in der Datenbank befinden, schlägt der Vorgang fehl.
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie mithilfe des CheckTransactionStatus API-Aufrufs für die Nachverfolgung verwenden können.
Die API kann nur verwendet werden, wenn der GetCatalog API-Aufruf als Antwort darauf hinweistuse-extensions=true.

DeleteNamespace

Allgemeine Informationen
Name der Operation	DeleteNamespace
Typ	Iceberg REST-Katalog-API
REST-Pfad	DELETE/iceberg/v1/catalogs/{catalog}/namespces/{ns}
IAM-Aktion	kleben: DeleteDatabase
Genehmigungen für Lake Formation	ALLES, FALLENLASSEN
CloudTrail event	kleben: DeleteDatabase
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L365

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Wenn sich Objekte in der Datenbank befinden, schlägt der Vorgang fehl.
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie mithilfe des CheckTransactionStatus API-Aufrufs für die Nachverfolgung verwenden können.
Die API kann nur verwendet werden, wenn der GetCatalog API-Aufruf als Antwort darauf hinweistuse-extensions=true.

Allgemeine Informationen
Name der Operation	StartDeleteNamespaceTransaction
Typ	AWS Glue Erweiterungs-API
REST-Pfad	DELETE /extensions/v1/catalogs/{catalog}/namespces/{ns}
IAM-Aktion	kleben: DeleteDatabase
Genehmigungen für Lake Formation	ALLES, FALLENLASSEN
CloudTrail event	kleben: DeleteDatabase
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L85

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Wenn sich Objekte in der Datenbank befinden, schlägt der Vorgang fehl.
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie mithilfe des CheckTransactionStatus API-Aufrufs für die Nachverfolgung verwenden können.
Die API kann nur verwendet werden, wenn der GetCatalog API-Aufruf als Antwort darauf hinweistuse-extensions=true.

StartDeleteNamespaceTransaction

Allgemeine Informationen
Name der Operation	StartDeleteNamespaceTransaction
Typ	AWS Glue Erweiterungs-API
REST-Pfad	DELETE /extensions/v1/catalogs/{catalog}/namespces/{ns}
IAM-Aktion	kleben: DeleteDatabase
Genehmigungen für Lake Formation	ALLES, FALLENLASSEN
CloudTrail event	kleben: DeleteDatabase
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L85

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Wenn sich Objekte in der Datenbank befinden, schlägt der Vorgang fehl.
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie mithilfe des CheckTransactionStatus API-Aufrufs für die Nachverfolgung verwenden können.
Die API kann nur verwendet werden, wenn der GetCatalog API-Aufruf als Antwort darauf hinweistuse-extensions=true.

Allgemeine Informationen
Name der Operation	ListTables
Typ	Iceberg REST-Katalog-API
REST-Pfad	GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables
IAM-Aktion	kleben: GetTables
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail event	kleben: GetTables
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L463

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Alle Tabellen, auch Tabellen, die nicht zu ICEBERG gehören, werden aufgelistet. Um festzustellen, ob eine Tabelle als Iceberg-Tabelle geladen werden kann oder nicht, rufen Sie operation auf. LoadTable

ListTables

Allgemeine Informationen
Name der Operation	ListTables
Typ	Iceberg REST-Katalog-API
REST-Pfad	GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables
IAM-Aktion	kleben: GetTables
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail event	kleben: GetTables
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L463

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Alle Tabellen, auch Tabellen, die nicht zu ICEBERG gehören, werden aufgelistet. Um festzustellen, ob eine Tabelle als Iceberg-Tabelle geladen werden kann oder nicht, rufen Sie operation auf. LoadTable

Allgemeine Informationen
Name der Operation	CreateTable
Typ	Iceberg REST-Katalog-API
REST-Pfad	GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables
IAM-Aktion	kleben: CreateTable
Genehmigungen für Lake Formation	ALLE, CREATE_TABLE
CloudTrail event	kleben: CreateTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L497

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
CreateTablemit Staging wird nicht unterstützt. Wenn der stageCreate Abfrageparameter angegeben ist, schlägt der Vorgang fehl. Das bedeutet, dass Operation like CREATE TABLE AS SELECT nicht unterstützt wird und Sie eine Kombination aus CREATE TABLE und INSERT INTO als Workaround verwenden können.
Der CreateTable API-Vorgang unterstützt die Option nicht. state-create = TRUE

CreateTable

Allgemeine Informationen
Name der Operation	CreateTable
Typ	Iceberg REST-Katalog-API
REST-Pfad	GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables
IAM-Aktion	kleben: CreateTable
Genehmigungen für Lake Formation	ALLE, CREATE_TABLE
CloudTrail event	kleben: CreateTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L497

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
CreateTablemit Staging wird nicht unterstützt. Wenn der stageCreate Abfrageparameter angegeben ist, schlägt der Vorgang fehl. Das bedeutet, dass Operation like CREATE TABLE AS SELECT nicht unterstützt wird und Sie eine Kombination aus CREATE TABLE und INSERT INTO als Workaround verwenden können.
Der CreateTable API-Vorgang unterstützt die Option nicht. state-create = TRUE

Allgemeine Informationen
Name der Operation	CreateTable
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables
IAM-Aktion	kleben: CreateTable
Genehmigungen für Lake Formation	ALLE, CREATE_TABLE
CloudTrail event	kleben: CreateTable
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L107

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
CreateTablemit Staging wird nicht unterstützt. Wenn der stageCreate Abfrageparameter angegeben ist, schlägt der Vorgang fehl. Das bedeutet, dass die Operation like nicht unterstützt CREATE TABLE AS SELECT wird und der Benutzer eine Kombination aus und verwenden sollte, um das Problem zu umgehenCREATE TABLE. INSERT INTO
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie für die Nachverfolgung mithilfe des API-Aufrufs verwenden können. CheckTransactionStatus
Die API kann nur verwendet werden, wenn der GetCatalog API-Aufruf als Antwort darauf hinweistuse-extensions=true.

StartCreateTableTransaction

Allgemeine Informationen
Name der Operation	CreateTable
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables
IAM-Aktion	kleben: CreateTable
Genehmigungen für Lake Formation	ALLE, CREATE_TABLE
CloudTrail event	kleben: CreateTable
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L107

Überlegungen und Einschränkungen

Der Katalogpfadparameter muss dem im Parameter für Präfix und Katalogpfad Abschnitt beschriebenen Stil entsprechen.
Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
CreateTablemit Staging wird nicht unterstützt. Wenn der stageCreate Abfrageparameter angegeben ist, schlägt der Vorgang fehl. Das bedeutet, dass die Operation like nicht unterstützt CREATE TABLE AS SELECT wird und der Benutzer eine Kombination aus und verwenden sollte, um das Problem zu umgehenCREATE TABLE. INSERT INTO
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie für die Nachverfolgung mithilfe des API-Aufrufs verwenden können. CheckTransactionStatus
Die API kann nur verwendet werden, wenn der GetCatalog API-Aufruf als Antwort darauf hinweistuse-extensions=true.

Allgemeine Informationen
Vorgangsname	LoadTable
Typ	AWS Glue Erweiterungs-API
REST-Pfad	GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: GE TTable
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail Ereignis	kleben: GetTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L616

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen Namespace mit einer einzigen Ebene angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
CreateTablemit Staging wird nicht unterstützt. Wenn der stageCreate Abfrageparameter angegeben ist, schlägt der Vorgang fehl. Das bedeutet, dass die Operation like nicht unterstützt CREATE TABLE AS SELECT wird und der Benutzer eine Kombination aus und verwenden sollte, um das Problem zu umgehenCREATE TABLE. INSERT INTO
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie für die Nachverfolgung mithilfe des API-Aufrufs verwenden können. CheckTransactionStatus
Die API kann nur verwendet werden, wenn der GetCatalog API-Aufruf als Antwort darauf hinweistuse-extensions=true.

LoadTable

Allgemeine Informationen
Vorgangsname	LoadTable
Typ	AWS Glue Erweiterungs-API
REST-Pfad	GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: GE TTable
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail Ereignis	kleben: GetTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L616

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen Namespace mit einer einzigen Ebene angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
CreateTablemit Staging wird nicht unterstützt. Wenn der stageCreate Abfrageparameter angegeben ist, schlägt der Vorgang fehl. Das bedeutet, dass die Operation like nicht unterstützt CREATE TABLE AS SELECT wird und der Benutzer eine Kombination aus und verwenden sollte, um das Problem zu umgehenCREATE TABLE. INSERT INTO
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie für die Nachverfolgung mithilfe des API-Aufrufs verwenden können. CheckTransactionStatus
Die API kann nur verwendet werden, wenn der GetCatalog API-Aufruf als Antwort darauf hinweistuse-extensions=true.

Allgemeine Informationen
Vorgangsname	LoadTable
Typ	AWS Glue Erweiterungs-API
REST-Pfad	GET /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: GetTable
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail Ereignis	kleben: GetTable
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L134

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Für den Abfrageparameter Snapshots wird nur der all Modus unterstützt.

Im Vergleich zur LoadTable API unterscheidet sich die ExtendedLoadTable API in folgenden Punkten:

Erzwingt nicht unbedingt, dass alle Felder verfügbar sind.

stellt die folgenden zusätzlichen Parameter im Konfigurationsfeld der Antwort bereit:

Zusätzliche Parameter
Konfigurationsschlüssel	Beschreibung
aws. server-side-capabilities.scan-Planung	Gibt an, ob die Tabelle mit der Tabelle und gescannt werden kann. PreparePlan PlanTable APIs
war. server-side-capabilities.data-commit	Gibt an, ob die Tabelle mithilfe der Transaktion festgeschrieben werden kann. StartUpdateTable
aws.glue.staging.location	Wird für die serverseitige Scanplanung oder Datenübergabe verwendet. Dabei handelt es sich um einen vom Service verwalteten Staging-Speicherort, der für das Modul zum Schreiben temporärer Datendateien verwendet werden kann
aws.glue.staging. access-key-id	Wird für die serverseitige Scanplanung oder Datenübergabe verwendet und ist ein Teil der temporären AWS Anmeldeinformationen für den Zugriff auf den vom Service verwalteten Staging-Speicherort
aws.glue.staging. secret-access-key	Wird für die serverseitige Scanplanung oder Datenübergabe verwendet und ist ein Teil der temporären AWS Anmeldeinformationen für den Zugriff auf den vom Service verwalteten Staging-Speicherort.
aws.glue.staging.session-token	Wird für die serverseitige Scanplanung oder Datenübergabe verwendet und ist ein Teil der temporären Anmeldeinformationen für den Zugriff auf den vom Service verwalteten Staging-Speicherort AWS .
aws.glue.staging.expiration-ms	Wird für die serverseitige Scanplanung oder die Datenübergabe verwendet, Ablaufzeit der Anmeldeinformationen für den Zugriff auf das vom Service verwaltete Staging.
aws.glue.staging. data-transfer-role-arn	Wird für die serverseitige Scanplanung oder Datenübergabe verwendet, eine IAM-Rolle, von der angenommen werden kann, dass sie auf den vom Service verwalteten Staging-Speicherort zugreift.

ExtendedLoadTable

Allgemeine Informationen
Vorgangsname	LoadTable
Typ	AWS Glue Erweiterungs-API
REST-Pfad	GET /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: GetTable
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail Ereignis	kleben: GetTable
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L134

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Für den Abfrageparameter Snapshots wird nur der all Modus unterstützt.

Im Vergleich zur LoadTable API unterscheidet sich die ExtendedLoadTable API in folgenden Punkten:

Erzwingt nicht unbedingt, dass alle Felder verfügbar sind.

stellt die folgenden zusätzlichen Parameter im Konfigurationsfeld der Antwort bereit:

Zusätzliche Parameter
Konfigurationsschlüssel	Beschreibung
aws. server-side-capabilities.scan-Planung	Gibt an, ob die Tabelle mit der Tabelle und gescannt werden kann. PreparePlan PlanTable APIs
war. server-side-capabilities.data-commit	Gibt an, ob die Tabelle mithilfe der Transaktion festgeschrieben werden kann. StartUpdateTable
aws.glue.staging.location	Wird für die serverseitige Scanplanung oder Datenübergabe verwendet. Dabei handelt es sich um einen vom Service verwalteten Staging-Speicherort, der für das Modul zum Schreiben temporärer Datendateien verwendet werden kann
aws.glue.staging. access-key-id	Wird für die serverseitige Scanplanung oder Datenübergabe verwendet und ist ein Teil der temporären AWS Anmeldeinformationen für den Zugriff auf den vom Service verwalteten Staging-Speicherort
aws.glue.staging. secret-access-key	Wird für die serverseitige Scanplanung oder Datenübergabe verwendet und ist ein Teil der temporären AWS Anmeldeinformationen für den Zugriff auf den vom Service verwalteten Staging-Speicherort.
aws.glue.staging.session-token	Wird für die serverseitige Scanplanung oder Datenübergabe verwendet und ist ein Teil der temporären Anmeldeinformationen für den Zugriff auf den vom Service verwalteten Staging-Speicherort AWS .
aws.glue.staging.expiration-ms	Wird für die serverseitige Scanplanung oder die Datenübergabe verwendet, Ablaufzeit der Anmeldeinformationen für den Zugriff auf das vom Service verwaltete Staging.
aws.glue.staging. data-transfer-role-arn	Wird für die serverseitige Scanplanung oder Datenübergabe verwendet, eine IAM-Rolle, von der angenommen werden kann, dass sie auf den vom Service verwalteten Staging-Speicherort zugreift.

Allgemeine Informationen
Vorgangsname	PreplanTable
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/preplan
IAM-Aktion	kleben: GetTable
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail Ereignis	kleben: GetTable
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L211

Überlegungen

Der Katalogpfadparameter sollte dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Der Aufrufer dieser API sollte immer anhand des Seitentokens feststellen, ob noch Ergebnisse abgerufen werden müssen. Eine Antwort mit leerem Seitenelement, aber einem Paginierungstoken ist möglich, wenn die Serverseite noch verarbeitet, aber in der angegebenen Antwortzeit kein Ergebnis erzielen kann.
Sie können diese API nur verwenden, wenn die ExtendedLoadTable API-Antwort Folgendes enthältaws.server-side-capabilities.scan-planning=true:

PreplanTable

Allgemeine Informationen
Vorgangsname	PreplanTable
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/preplan
IAM-Aktion	kleben: GetTable
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail Ereignis	kleben: GetTable
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L211

Überlegungen

Der Katalogpfadparameter sollte dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Der Aufrufer dieser API sollte immer anhand des Seitentokens feststellen, ob noch Ergebnisse abgerufen werden müssen. Eine Antwort mit leerem Seitenelement, aber einem Paginierungstoken ist möglich, wenn die Serverseite noch verarbeitet, aber in der angegebenen Antwortzeit kein Ergebnis erzielen kann.
Sie können diese API nur verwenden, wenn die ExtendedLoadTable API-Antwort Folgendes enthältaws.server-side-capabilities.scan-planning=true:

Allgemeine Informationen
Vorgangsname	PlanTable
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/plan
IAM-Aktion	kleben: GetTable
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail Ereignis	kleben: GetTable
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L243

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Der Aufrufer dieser API sollte immer anhand des Seitentokens feststellen, ob noch Ergebnisse abgerufen werden müssen. Eine Antwort mit leerem Seitenelement, aber einem Paginierungstoken ist möglich, wenn die Serverseite noch verarbeitet, aber in der angegebenen Antwortzeit kein Ergebnis erzielen kann.
Sie können diese API nur verwenden, wenn die ExtendedLoadTable API-Antwort Folgendes enthältaws.server-side-capabilities.scan-planning=true.

PlanTable

Allgemeine Informationen
Vorgangsname	PlanTable
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/plan
IAM-Aktion	kleben: GetTable
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail Ereignis	kleben: GetTable
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L243

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Der Aufrufer dieser API sollte immer anhand des Seitentokens feststellen, ob noch Ergebnisse abgerufen werden müssen. Eine Antwort mit leerem Seitenelement, aber einem Paginierungstoken ist möglich, wenn die Serverseite noch verarbeitet, aber in der angegebenen Antwortzeit kein Ergebnis erzielen kann.
Sie können diese API nur verwenden, wenn die ExtendedLoadTable API-Antwort Folgendes enthältaws.server-side-capabilities.scan-planning=true.

Allgemeine Informationen
Vorgangsname	TableExists
Typ	Iceberg REST-Katalog-API
REST-Pfad	HEAD/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: GetTable
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail Ereignis	kleben: GetTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L833

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.

TableExists

Allgemeine Informationen
Vorgangsname	TableExists
Typ	Iceberg REST-Katalog-API
REST-Pfad	HEAD/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: GetTable
Genehmigungen für Lake Formation	ANRUFEN, AUSWÄHLEN, BESCHREIBEN
CloudTrail Ereignis	kleben: GetTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L833

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.

Allgemeine Informationen
Vorgangsname	UpdateTable
Typ	Iceberg REST-Katalog-API
REST-Pfad	POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: UpdateTable
Genehmigungen für Lake Formation	ANRUFEN, SPÄTER
CloudTrail Ereignis	kleben: UpdateTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L677

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.

UpdateTable

Allgemeine Informationen
Vorgangsname	UpdateTable
Typ	Iceberg REST-Katalog-API
REST-Pfad	POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: UpdateTable
Genehmigungen für Lake Formation	ANRUFEN, SPÄTER
CloudTrail Ereignis	kleben: UpdateTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L677

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.

Allgemeine Informationen
Vorgangsname	StartUpdateTableTransaction
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: UpdateTable
Genehmigungen für Lake Formation	RUF AN, SPÄTER
CloudTrail Ereignis	kleben: UpdateTable
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L154

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie für die Nachverfolgung mithilfe des CheckTransactionStatus API-Aufrufs verwenden können.
Ein RenamTable Vorgang kann auch über diese API ausgeführt werden. In diesem Fall muss der Aufrufer auch über die Glue: - CreateTable oder LakeFormation CREATE_TABLE-Berechtigung verfügen, damit die Tabelle umbenannt werden kann.
Sie können diese API nur verwenden, wenn die ExtendedLoadTable API-Antwort Folgendes enthält: aws.server-side-capabilities.scan-planning=true

StartUpdateTableTransaction

Allgemeine Informationen
Vorgangsname	StartUpdateTableTransaction
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: UpdateTable
Genehmigungen für Lake Formation	RUF AN, SPÄTER
CloudTrail Ereignis	kleben: UpdateTable
API-Definition öffnen	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L154

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
Die API ist asynchron und gibt eine Transaktions-ID zurück, die Sie für die Nachverfolgung mithilfe des CheckTransactionStatus API-Aufrufs verwenden können.
Ein RenamTable Vorgang kann auch über diese API ausgeführt werden. In diesem Fall muss der Aufrufer auch über die Glue: - CreateTable oder LakeFormation CREATE_TABLE-Berechtigung verfügen, damit die Tabelle umbenannt werden kann.
Sie können diese API nur verwenden, wenn die ExtendedLoadTable API-Antwort Folgendes enthält: aws.server-side-capabilities.scan-planning=true

Allgemeine Informationen
Vorgangsname	DeleteTable
Typ	Iceberg REST-Katalog-API
REST-Pfad	DELETE/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: DeleteTable
Genehmigungen für Lake Formation	ALLES, FALLENLASSEN
CloudTrail Ereignis	kleben: DeleteTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L793

Überlegungen

Der Parameter für den Katalogpfad sollte dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
DeleteTableDer API-Betrieb unterstützt eine Bereinigungsoption. Wenn Purge auf eingestellt isttrue, werden die Tabellendaten gelöscht, andernfalls werden die Daten nicht gelöscht. Bei Tabellen in Amazon S3 löscht der Vorgang keine Tabellendaten. Der Vorgang schlägt fehl, wenn die Tabelle in Amazon S3 gespeichert ist, undpurge = TRUE,.

Bei Tabellen, die im verwalteten Amazon Redshift-Speicher gespeichert sind, löscht der Vorgang Tabellendaten, ähnlich dem DROP TABLE Verhalten in Amazon Redshift. Der Vorgang schlägt fehl, wenn die Tabelle in Amazon Redshift und purge = FALSE gespeichert ist.
purgeRequest=true wird nicht unterstützt.

DeleteTable

Allgemeine Informationen
Vorgangsname	DeleteTable
Typ	Iceberg REST-Katalog-API
REST-Pfad	DELETE/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: DeleteTable
Genehmigungen für Lake Formation	ALLES, FALLENLASSEN
CloudTrail Ereignis	kleben: DeleteTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L793

Überlegungen

Der Parameter für den Katalogpfad sollte dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
DeleteTableDer API-Betrieb unterstützt eine Bereinigungsoption. Wenn Purge auf eingestellt isttrue, werden die Tabellendaten gelöscht, andernfalls werden die Daten nicht gelöscht. Bei Tabellen in Amazon S3 löscht der Vorgang keine Tabellendaten. Der Vorgang schlägt fehl, wenn die Tabelle in Amazon S3 gespeichert ist, undpurge = TRUE,.

Bei Tabellen, die im verwalteten Amazon Redshift-Speicher gespeichert sind, löscht der Vorgang Tabellendaten, ähnlich dem DROP TABLE Verhalten in Amazon Redshift. Der Vorgang schlägt fehl, wenn die Tabelle in Amazon Redshift und purge = FALSE gespeichert ist.
purgeRequest=true wird nicht unterstützt.

Allgemeine Informationen
Vorgangsname	StartDeleteTableTransaction
Typ	AWS Glue Erweiterungs-API
REST-Pfad	DELETE /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: DeleteTable
Genehmigungen für Lake Formation	ALLES, FALLENLASSEN
CloudTrail Ereignis	kleben: DeleteTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L793

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
purgeRequest=false wird nicht unterstützt.
Die API ist asynchron und gibt eine Transaktions-ID zurück, über CheckTransactionStatus die nachverfolgt werden kann.

StartDeleteTableTransaction

Allgemeine Informationen
Vorgangsname	StartDeleteTableTransaction
Typ	AWS Glue Erweiterungs-API
REST-Pfad	DELETE /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion	Klebstoff: DeleteTable
Genehmigungen für Lake Formation	ALLES, FALLENLASSEN
CloudTrail Ereignis	kleben: DeleteTable
API-Definition öffnen	https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L793

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad
Sie können im REST-Path-Parameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Namespace-Pfadparameter Abschnitt.
purgeRequest=false wird nicht unterstützt.
Die API ist asynchron und gibt eine Transaktions-ID zurück, über CheckTransactionStatus die nachverfolgt werden kann.

Allgemeine Informationen
Vorgangsname	CheckTransactionStatus
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST/extensions/v1/transactions/status
IAM-Aktion	Dieselbe Berechtigung wie die Aktion, die die Transaktion initiiert
Genehmigungen für Lake Formation	Dieselbe Berechtigung wie die Aktion, die die Transaktion initiiert
Öffnen Sie die API-Definition	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L273

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad

CheckTransactionStatus

Allgemeine Informationen
Vorgangsname	CheckTransactionStatus
Typ	AWS Glue Erweiterungs-API
REST-Pfad	POST/extensions/v1/transactions/status
IAM-Aktion	Dieselbe Berechtigung wie die Aktion, die die Transaktion initiiert
Genehmigungen für Lake Formation	Dieselbe Berechtigung wie die Aktion, die die Transaktion initiiert
Öffnen Sie die API-Definition	https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml #L273

Überlegungen

Der Katalogpfadparameter muss dem im Abschnitt beschriebenen Stil entsprechen. Parameter für Präfix und Katalogpfad

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Verbindung zum Datenkatalog mithilfe des AWS Glue Iceberg-REST-Erweiterungsendpunkts herstellen

Von einer eigenständigen Spark-Anwendung aus eine Verbindung zum Datenkatalog herstellen

Nächstes Thema:

Von einer eigenständigen Spark-Anwendung aus eine Verbindung zum Datenkatalog herstellen

Vorheriges Thema:

Verbindung zum Datenkatalog mithilfe des AWS Glue Iceberg-REST-Erweiterungsendpunkts herstellen

Brauchen Sie Hilfe?

Wählen Sie Ihre Cookie-Einstellungen aus

AWS Glue REST APIs für Apache Iceberg-Spezifikationen

Überlegungen und Einschränkungen

GetConfig

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

GetCatalog

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

ListNamespaces

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

CreateNamespace

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

StartCreateNamespaceTransaction

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

LoadNamespaceMetadata

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

UpdateNamespaceProperties

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

DeleteNamespace

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

StartDeleteNamespaceTransaction

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

ListTables

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

CreateTable

Überlegungen und Einschränkungen

Überlegungen und Einschränkungen

StartCreateTableTransaction

Überlegungen und Einschränkungen

Überlegungen

LoadTable

Überlegungen

Überlegungen

ExtendedLoadTable

Überlegungen

Überlegungen

PreplanTable

Überlegungen

Überlegungen

PlanTable

Überlegungen

Überlegungen

TableExists

Überlegungen

Überlegungen

UpdateTable

Überlegungen

Überlegungen

StartUpdateTableTransaction

Überlegungen

Überlegungen

DeleteTable

Überlegungen

Überlegungen

StartDeleteTableTransaction

Überlegungen

Überlegungen

CheckTransactionStatus

Überlegungen

Nächstes Thema:

Vorheriges Thema:

Brauchen Sie Hilfe?

Related resources

Hat Ihnen diese Seite geholfen?

Related resources