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.

AWS Glue REST APIs für Apache Iceberg-Spezifikationen

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 die Objekte kann mithilfe von IAM-, Lake-Formation- oder Lake-Formation-Hybridmodus-Berechtigungen verwaltet werden.

Verbundkataloge im Datenkatalog weisen in Lake Formation registrierte Datenspeicherorte auf. Lake Formation arbeitet mit dem Datenkatalog zusammen, um Datenbanken ähnliche Berechtigungen für die 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 von Lake Formation verwalteten Objekten zu erstellen, einzufügen oder zu löschen, müssen Sie bestimmte 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 — Für drop/delete eine Tabelle oder Datenbank erforderlich

  • INSERT – erforderlich, wenn der Prinzipal Daten in eine Tabelle einfügen muss

  • SELECT – erforderlich, wenn der Prinzipal 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
Vorgangsname GetConfig
Typ

REST-Katalog-API von Iceberg
REST-Pfad

HOLEN/iceberg/v1/config
IAM-Aktion

kleben: GetCatalog
Lake-Formation-Berechtigungen Nicht zutreffend
CloudTrail event

kleben: GetCatalog
OpenAPI-Definition 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 gesetzt werden. Wenn nicht festgelegt, wird der Stammkatalog im aktuellen Konto verwendet, um die Antwort zurückzugeben. Weitere Informationen finden Sie unter Präfix- und Katalogpfadparameter.

Allgemeine Informationen
Vorgangsname GetCatalog
Typ

AWS Glue Erweiterungs-API
REST-Pfad

GET/extensions/v1/catalogs/{katalog}
IAM-Aktion

Klebstoff: GetCatalog
Lake-Formation-Berechtigungen DESCRIBE
CloudTrail event

kleben: GetCatalog
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-Erweiterungen-api.yaml #L40
Überlegungen und Einschränkungen
Allgemeine Informationen
Vorgangsname ListNamespaces
Typ

REST-Katalog-API von Iceberg
REST-Pfad

GET/iceberg/v1/catalogs/{catalog}/namespaces
IAM-Aktion

kleben: GetDatabase
Lake-Formation-Berechtigungen ALL, DESCRIBE, SELECT
CloudTrail event

kleben: GetDatabase
OpenAPI-Definition 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 Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Es werden nur Namespaces der nächsten Ebene angezeigt. Um Namespaces auf tieferen Ebenen aufzulisten, geben Sie die ID des geschachtelten Katalogs im Katalogpfadparameter an.

Allgemeine Informationen
Vorgangsname CreateNamespace
Typ

REST-Katalog-API von Iceberg
REST-Pfad

POST/iceberg/v1/catalogs/{catalog}/namespaces
IAM-Aktion

kleben: CreateDatabase
Lake-Formation-Berechtigungen ALL, DESCRIBE, SELECT
CloudTrail event

kleben: CreateDatabase
OpenAPI-Definition 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 Abschnitt Präfix- und Katalogpfadparameter 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 mit der Ebene herstellen.

Allgemeine Informationen
Vorgangsname StartCreateNamespaceTransaction
Typ

AWS Glue Erweiterungs-API
REST-Pfad

POST/extensions/v1/catalogs/{catalog}/namespaces
IAM-Aktion

kleben: CreateDatabase
Lake-Formation-Berechtigungen ALL, DESCRIBE, SELECT
CloudTrail event

kleben: CreateDatabase
OpenAPI-Definition 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 Abschnitt Präfix- und Katalogpfadparameter 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 mit der Ebene herstellen.

  • 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.

  • Sie können diese API nur aufrufen, wenn der GetCatalog-API-Aufruf den Parameter use-extensions=true in der Antwort enthält.

Allgemeine Informationen
Vorgangsname LoadNamespaceMetadata
Typ

REST-Katalog-API von Iceberg
REST-Pfad

GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns}
IAM-Aktion

kleben: GetDatabase
Lake-Formation-Berechtigungen ALL, DESCRIBE, SELECT
CloudTrail event

kleben: GetDatabase
OpenAPI-Definition https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L302
Überlegungen und Einschränkungen
Allgemeine Informationen
Vorgangsname UpdateNamespaceProperties
Typ

REST-Katalog-API von Iceberg
REST-Pfad

BEITRAG/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties
IAM-Aktion

kleben: UpdateDatabase
Lake-Formation-Berechtigungen ALL, ALTER
CloudTrail event

kleben: UpdateDatabase
OpenAPI-Definition https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L400
Überlegungen und Einschränkungen
Allgemeine Informationen
Vorgangsname DeleteNamespace
Typ

REST-Katalog-API von Iceberg
REST-Pfad

DELETE/iceberg/v1/catalogs/{catalog}/namespces/{ns}
IAM-Aktion

kleben: DeleteDatabase
Lake-Formation-Berechtigungen ALL, DROP
CloudTrail event

kleben: DeleteDatabase
OpenAPI-Definition 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 Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • 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 für die Nachverfolgung mithilfe des CheckTransactionStatus-API-Aufrufs verwenden können.

  • Die API kann nur verwendet werden, wenn der GetCatalog-API-Aufruf als Antwort use-extensions=true angibt.

Allgemeine Informationen
Vorgangsname StartDeleteNamespaceTransaction
Typ

AWS Glue Erweiterungs-API
REST-Pfad

/extensions/v1/catalogs/{catalog}/namespces/{ns} LÖSCHEN
IAM-Aktion

kleben: DeleteDatabase
Lake-Formation-Berechtigungen ALL, DROP
CloudTrail event

kleben: DeleteDatabase
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-Erweiterungen-api.yaml #L85
Überlegungen und Einschränkungen

  • Der Katalogpfadparameter muss dem im Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • 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 für die Nachverfolgung mithilfe des CheckTransactionStatus-API-Aufrufs verwenden können.

  • Die API kann nur verwendet werden, wenn der GetCatalog-API-Aufruf als Antwort use-extensions=true angibt.

Allgemeine Informationen
Vorgangsname ListTables
Typ

REST-Katalog-API von Iceberg
REST-Pfad

HOLEN/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables
IAM-Aktion

kleben: GetTables
Lake-Formation-Berechtigungen ALL, SELECT, DESCRIBE
CloudTrail event

kleben: GetTables
OpenAPI-Definition 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 Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • Alle Tabellen, auch wenn es sich nicht um Iceberg-Tabellen handelt, werden aufgelistet. Um festzustellen, ob eine Tabelle als Iceberg-Tabelle geladen werden kann oder nicht, rufen Sie den LoadTable-Vorgang auf.

Allgemeine Informationen
Vorgangsname CreateTable
Typ

REST-Katalog-API von Iceberg
REST-Pfad

HOLEN/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables
IAM-Aktion

kleben: CreateTable
Lake-Formation-Berechtigungen ALL, CREATE_TABLE
CloudTrail event

kleben: CreateTable
OpenAPI-Definition 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 Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • CreateTable mit Staging wird nicht unterstützt. Wenn der Abfrageparameter stageCreate angegeben ist, schlägt der Vorgang fehl. Das bedeutet, dass ein Vorgang wie CREATE TABLE AS SELECT nicht unterstützt wird und Sie können eine Kombination aus CREATE TABLE und INSERT INTO verwenden muss, um das Problem zu umgehen.

  • Der CreateTable-API-Vorgang unterstützt die Option state-create = TRUE nicht.

Allgemeine Informationen
Vorgangsname CreateTable
Typ

AWS Glue Erweiterungs-API
REST-Pfad

POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables
IAM-Aktion

kleben: CreateTable
Lake-Formation-Berechtigungen ALL, CREATE_TABLE
CloudTrail event

kleben: CreateTable
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-Erweiterungen-api.yaml #L107
Überlegungen und Einschränkungen

  • Der Katalogpfadparameter muss dem im Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • CreateTable mit Staging wird nicht unterstützt. Wenn der stageCreate Abfrageparameter angegeben ist, schlägt der Vorgang fehl. Das bedeutet, dass ein Vorgang wie CREATE TABLE AS SELECT nicht unterstützt wird und der Benutzer eine Kombination aus CREATE TABLE und INSERT INTO verwenden muss, um das Problem zu umgehen.

  • 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.

  • Die API kann nur verwendet werden, wenn der GetCatalog-API-Aufruf als Antwort use-extensions=true angibt.

Allgemeine Informationen
Vorgangsname LoadTable
Typ

REST-Katalog-API von Iceberg
REST-Pfad

GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

Klebstoff: GetTable
Lake-Formation-Berechtigungen ALL, SELECT, DESCRIBE
CloudTrail Ereignis

kleben: GetTable
OpenAPI-Definition 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 Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • CreateTable mit Staging wird nicht unterstützt. Wenn der stageCreate Abfrageparameter angegeben ist, schlägt der Vorgang fehl. Das bedeutet, dass ein Vorgang wie CREATE TABLE AS SELECT nicht unterstützt wird und der Benutzer eine Kombination aus CREATE TABLE und INSERT INTO verwenden muss, um das Problem zu umgehen.

  • 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.

  • Die API kann nur verwendet werden, wenn der GetCatalog-API-Aufruf als Antwort use-extensions=true angibt.

Allgemeine Informationen
Vorgangsname LoadTable
Typ

AWS Glue Erweiterungs-API
REST-Pfad

GET/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

Klebstoff: GetTable
Lake-Formation-Berechtigungen ALL, SELECT, DESCRIBE
CloudTrail Ereignis

kleben: GetTable
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-Erweiterungen-api.yaml #L134
Überlegungen

  • Der Katalogpfadparameter muss dem im Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • Für den Abfrageparameter für 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 Description

      war. 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 die Datenübergabe verwendet. Dabei handelt es sich um einen vom Service verwalteten Staging-Speicherort, der für die Engine 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übernahme verwendet und ist ein Teil der temporären AWS Anmeldeinformationen für den Zugriff auf den vom Service verwalteten Staging-Speicherort.

      aws.glue.staging.expiration-ms

      Wird für die serverseitige Scanplanung oder die Datenübergabe verwendet; Ablaufzeit der Anmeldeinformationen für den Zugriff auf den vom Service verwalteten Staging-Speicherort.

      aws.glue.staging. data-transfer-role-arn

      Wird für die serverseitige Scanplanung oder die Datenübergabe verwendet. Dabei handelt es sich um 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

BEITRAG/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/preplan
IAM-Aktion

kleben: GetTable
Lake-Formation-Berechtigungen ALL, SELECT, DESCRIBE
CloudTrail Ereignis

kleben: GetTable
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-Erweiterungen-api.yaml #L211
Überlegungen

  • Der Katalogpfadparameter sollte dem im Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • Der Aufrufer dieser API muss immer anhand des Seitentokens ermitteln, 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 erzeugen kann.

  • Sie können diese API nur verwenden, wenn aws.server-side-capabilities.scan-planning=true in der ExtendedLoadTable-API-Antwort enthalten ist.

Allgemeine Informationen
Vorgangsname PlanTable
Typ

AWS Glue Erweiterungs-API
REST-Pfad

BEITRAG/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/plan
IAM-Aktion

kleben: GetTable
Lake-Formation-Berechtigungen ALL, SELECT, DESCRIBE
CloudTrail Ereignis

kleben: GetTable
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-Erweiterungen-api.yaml #L243
Überlegungen

  • Der Katalogpfadparameter muss dem im Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • Der Aufrufer dieser API muss immer anhand des Seitentokens ermitteln, 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 erzeugen kann.

  • Sie können diese API nur verwenden, wenn aws.server-side-capabilities.scan-planning=true in der ExtendedLoadTable-API-Antwort enthalten ist.

Allgemeine Informationen
Vorgangsname TableExists
Typ

REST-Katalog-API von Iceberg
REST-Pfad

HEAD/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

Klebstoff: GetTable
Lake-Formation-Berechtigungen ALL, SELECT, DESCRIBE
CloudTrail Ereignis

kleben: GetTable
OpenAPI-Definition https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L833
Überlegungen
Allgemeine Informationen
Vorgangsname UpdateTable
Typ

REST-Katalog-API von Iceberg
REST-Pfad

POST/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

kleben: UpdateTable
Lake-Formation-Berechtigungen ALL, ALTER
CloudTrail Ereignis

kleben: UpdateTable
OpenAPI-Definition https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L677
Überlegungen
Allgemeine Informationen
Vorgangsname StartUpdateTableTransaction
Typ AWS Glue Erweiterungs-API
REST-Pfad

POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

Klebstoff: UpdateTable
Lake-Formation-Berechtigungen

ALL, ALTER
CloudTrail Ereignis

kleben: UpdateTable
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-Erweiterungen-api.yaml #L154
Überlegungen

  • Der Katalogpfadparameter muss dem im Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • 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 die Glue: - CreateTable oder LakeFormation CREATE_TABLE-Berechtigung haben, damit die Tabelle umbenannt werden kann.

  • Sie können diese API nur verwenden, wenn aws.server-side-capabilities.scan-planning=true in der ExtendedLoadTable-API-Antwort enthalten ist.

Allgemeine Informationen
Vorgangsname DeleteTable
Typ

REST-Katalog-API von Iceberg
REST-Pfad

DELETE/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

Klebstoff: DeleteTable
Lake-Formation-Berechtigungen ALL, DROP
CloudTrail Ereignis

kleben: DeleteTable
OpenAPI-Definition https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml #L793
Überlegungen

  • Der Katalogpfadparameter sollte dem im Abschnitt Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • Der DeleteTable-API-Vorgang unterstützt eine Bereinigungsoption. Wenn die Bereinigungsoption auf true festgelegt ist, werden die Tabellendaten gelöscht, andernfalls werden keine Daten gelöscht. Bei Tabellen in Amazon S3 löscht der Vorgang keine Tabellendaten. Der Vorgang schlägt bei purge = TRUE, fehl, wenn die Tabelle in Amazon S3 gespeichert ist.

    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 bei purge = FALSE fehl, wenn die Tabelle in Amazon Redshift gespeichert ist.

  • purgeRequest=true wird nicht unterstützt.

Allgemeine Informationen
Vorgangsname StartDeleteTableTransaction
Typ

AWS Glue Erweiterungs-API
REST-Pfad

LÖSCHEN/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

kleben: DeleteTable
Lake-Formation-Berechtigungen ALL, DROP
CloudTrail Ereignis

kleben: DeleteTable
OpenAPI-Definition 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 Präfix- und Katalogpfadparameter beschriebenen Stil entsprechen.

  • Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt Namespace-Pfadparameter.

  • purgeRequest=false wird nicht unterstützt.

  • Die API ist asynchron und gibt eine Transaktions-ID zurück, die über CheckTransactionStatus 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
Lake-Formation-Berechtigungen Dieselbe Berechtigung wie die Aktion, die die Transaktion initiiert
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-Erweiterungen-api.yaml #L273
Überlegungen