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

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

Dieser Abschnitt enthält Spezifikationen zum AWS Glue-Iceberg-REST-Katalog und zu den AWS Glue-Erweiterungs-APIs sowie Hinweise zur Verwendung dieser APIs.

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

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

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-, AWS Lake Formation oder Lake-Formation-Hybridmodus-Berechtigungen verwenden, um den Zugriff auf den Standarddatenkatalog 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 – erforderlich, um eine Tabelle oder Datenbank zu entfernen/löschen

  • 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 unter Referenz zu Lake-Formation-Berechtigungen im AWS Lake Formation-Entwicklerhandbuch.

Allgemeine Informationen
Vorgangsname GetConfig
Typ

REST-Katalog-API von Iceberg
REST-Pfad

GET /iceberg/v1/config
IAM-Aktion

glue:GetCatalog
Lake-Formation-Berechtigungen Nicht zutreffend
CloudTrail-Ereignis

glue: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 festgelegt sein. 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

glue:GetCatalog
Lake-Formation-Berechtigungen DESCRIBE
CloudTrail-Ereignis

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

REST-Katalog-API von Iceberg
REST-Pfad

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

glue:GetDatabase
Lake-Formation-Berechtigungen ALL, DESCRIBE, SELECT
CloudTrail-Ereignis

glue: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/{Katalog}/namespaces
IAM-Aktion

glue:CreateDatabase
Lake-Formation-Berechtigungen ALL, DESCRIBE, SELECT
CloudTrail-Ereignis

glue: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/{Katalog}/namespaces
IAM-Aktion

glue:CreateDatabase
Lake-Formation-Berechtigungen ALL, DESCRIBE, SELECT
CloudTrail-Ereignis

glue: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

API des Iceberg-REST-Katalogs
REST-Pfad

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

glue:GetDatabase
Lake-Formation-Berechtigungen ALL, DESCRIBE, SELECT
CloudTrail-Ereignis

glue: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

API des Iceberg-REST-Katalogs
REST-Pfad

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

glue:UpdateDatabase
Lake-Formation-Berechtigungen ALL, ALTER
CloudTrail-Ereignis

glue: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/{Katalog}/namespces/{ns}
IAM-Aktion

glue:DeleteDatabase
Lake-Formation-Berechtigungen ALL, DROP
CloudTrail-Ereignis

glue: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

DELETE /extensions/v1/catalogs/{Katalog}/namespces/{ns}
IAM-Aktion

glue:DeleteDatabase
Lake-Formation-Berechtigungen ALL, DROP
CloudTrail-Ereignis

glue:DeleteDatabase
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-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

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

glue:GetTables
Lake-Formation-Berechtigungen ALL, SELECT, DESCRIBE
CloudTrail-Ereignis

glue: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

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

glue:CreateTable
Lake-Formation-Berechtigungen ALL, CREATE_TABLE
CloudTrail-Ereignis

glue: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/{Katalog}/namespaces/{ns}/tables
IAM-Aktion

glue:CreateTable
Lake-Formation-Berechtigungen ALL, CREATE_TABLE
CloudTrail-Ereignis

glue:CreateTable
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-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/{Katalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

glue:GeTTable
Lake-Formation-Berechtigungen ALL, SELECT, DESCRIBE
CloudTrail-Ereignis

glue: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 Abfrageparameter stageCreate 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/{table}
IAM-Aktion

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

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

  • Der Katalogpfadparameter muss dem im Präfix- und Katalogpfadparameter-Abschnitt 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 Beschreibung

      aws.server-side-capabilities.scan-planning

      		 Gibt an, ob die Tabelle mithilfe der PreparePlan-Tabelle und PlantTable-APIs gescannt werden kann.

      aws.server-side-capabilities.data-commit

      		 Gibt an, ob die Tabelle mithilfe der StartUpdateTable-Transaktion bestätigt werden kann.

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

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

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

glue:GetTable
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-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

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

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

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

  • Der Katalogpfadparameter muss dem im Präfix- und Katalogpfadparameter-Abschnitt 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/{Katalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

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

glue: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/{Katalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

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

glue: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/{Katalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

glue:UpdateTable
Lake-Formation-Berechtigungen

ALL, ALTER
CloudTrail-Ereignis

glue:UpdateTable
OpenAPI-Definition https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-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 über die Berechtigung glue:CreateTable oder LakeFormation CREATE_TABLE verfügen, 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

API des Iceberg-REST-Katalogs
REST-Pfad

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

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

glue: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

DELETE /extensions/v1/catalogs/{Katalog}/namespaces/{ns}/tables/{Tabelle}
IAM-Aktion

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

glue: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-extensions-api.yaml#L273
Überlegungen