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
<a name="iceberg-rest-apis"></a>

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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html). 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 ist`glue: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\$1CATALOG – erforderlich, um Kataloge zu erstellen 
+ CREATE\$1DATABASE – erforderlich, um Datenbanken zu erstellen
+ CREATE\$1TABLE – 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](https://docs.aws.amazon.com/lake-formation/latest/dg/lf-permissions-reference.html) im AWS Lake Formation Entwicklerhandbuch.

# GetConfig
<a name="get-config"></a>


**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 \$1L67 | 

****Ü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](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).

# GetCatalog
<a name="get-catalog"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | GetCatalog | 
| Typ |  AWS Glue Erweiterungs-API  | 
| REST-Pfad |  GET/extensions/v1/catalogs/\$1katalog\$1  | 
| 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 \$1L40 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.

# ListNamespaces
<a name="list-ns"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | ListNamespaces | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  GET/iceberg/v1/catalogs/\$1catalog\$1/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 \$1L205 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) 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.

# CreateNamespace
<a name="create-ns"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | CreateNamespace | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  POST/iceberg/v1/catalogs/\$1catalog\$1/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 \$1L256 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) 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.

# StartCreateNamespaceTransaction
<a name="start-create-ns-transaction"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | StartCreateNamespaceTransaction | 
| Typ |  AWS Glue Erweiterungs-API  | 
| REST-Pfad |  POST/extensions/v1/catalogs/\$1catalog\$1/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 \$1L256 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) 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. 

## LoadNamespaceMetadata
<a name="load-ns-metadata"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | LoadNamespaceMetadata | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  GET/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1  | 
| 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 \$1L302 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).

## UpdateNamespaceProperties
<a name="w2aac20c29c16c21c13"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | UpdateNamespaceProperties | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  BEITRAG/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/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 \$1L400 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).

# DeleteNamespace
<a name="delete-ns"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | DeleteNamespace | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  DELETE/iceberg/v1/catalogs/\$1catalog\$1/namespces/\$1ns\$1  | 
| 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 \$1L365 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ 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. 

# StartDeleteNamespaceTransaction
<a name="start-delete-ns-transaction"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | StartDeleteNamespaceTransaction | 
| Typ |  AWS Glue Erweiterungs-API  | 
| REST-Pfad |  /extensions/v1/catalogs/\$1catalog\$1/namespces/\$1ns\$1 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 \$1L85 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ 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. 

# ListTables
<a name="list-tables"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | ListTables | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  HOLEN/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/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 \$1L463 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ 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.

# CreateTable
<a name="create-table"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | CreateTable | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  HOLEN/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables  | 
| IAM-Aktion |  kleben: CreateTable  | 
| Lake-Formation-Berechtigungen | ALL, CREATE\$1TABLE | 
| CloudTrail event |  kleben: CreateTable  | 
| OpenAPI-Definition | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L497 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ `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.

# StartCreateTableTransaction
<a name="start-create-table-transaction"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | CreateTable | 
| Typ |  AWS Glue Erweiterungs-API  | 
| REST-Pfad |  POST/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables  | 
| IAM-Aktion |  kleben: CreateTable  | 
| Lake-Formation-Berechtigungen | ALL, CREATE\$1TABLE | 
| CloudTrail event |  kleben: CreateTable  | 
| OpenAPI-Definition | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-Erweiterungen-api.yaml \$1L107 | 

****Überlegungen und Einschränkungen****
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ `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. 

# LoadTable
<a name="load-table"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | LoadTable | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  GET/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1Tabelle\$1  | 
| 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 \$1L616 | 

**Überlegungen**
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ `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. 

# ExtendedLoadTable
<a name="extended-load-table"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | LoadTable | 
| Typ |  AWS Glue Erweiterungs-API  | 
| REST-Pfad |  GET/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1Tabelle\$1  | 
| 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 \$1L134 | 

**Überlegungen**
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ 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**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/extended-load-table.html)

# PreplanTable
<a name="preplan-table"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | PreplanTable | 
| Typ |  AWS Glue Erweiterungs-API  | 
| REST-Pfad |  BEITRAG/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1/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 \$1L211 | 

**Überlegungen**
+ Der Katalogpfadparameter sollte dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ 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. 

# PlanTable
<a name="plan-table"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | PlanTable | 
| Typ |  AWS Glue Erweiterungs-API  | 
| REST-Pfad |  BEITRAG/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1/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 \$1L243 | 

**Überlegungen**
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ 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. 

# TableExists
<a name="table-exists"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | TableExists | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  HEAD/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1Tabelle\$1  | 
| 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 \$1L833 | 

**Überlegungen**
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).

# UpdateTable
<a name="update-table"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | UpdateTable | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  POST/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1Tabelle\$1  | 
| 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 \$1L677 | 

**Überlegungen**
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).

# StartUpdateTableTransaction
<a name="start-update-table-transaction"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | StartUpdateTableTransaction | 
| Typ | AWS Glue Erweiterungs-API | 
| REST-Pfad |  POST/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1Tabelle\$1  | 
| 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 \$1L154 | 

**Überlegungen**
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ 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\$1TABLE-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. 

# DeleteTable
<a name="delete-table"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | DeleteTable | 
| Typ |  REST-Katalog-API von Iceberg  | 
| REST-Pfad |  DELETE/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1Tabelle\$1  | 
| 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 \$1L793 | 

**Überlegungen**
+ Der Katalogpfadparameter sollte dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ 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. 

# StartDeleteTableTransaction
<a name="start-delete-table-transaction"></a>


**Allgemeine Informationen**  

|  |  | 
| --- |--- |
| Vorgangsname | StartDeleteTableTransaction | 
| Typ |  AWS Glue Erweiterungs-API  | 
| REST-Pfad |  LÖSCHEN/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1Tabelle\$1  | 
| 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 \$1L793 | 

**Überlegungen**
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.
+ Sie können im REST-Pfadparameter nur einen einstufigen Namespace angeben. Weitere Informationen finden Sie im Abschnitt [Namespace-Pfadparameter](connect-glu-iceberg-rest.md#ns-path-param).
+ `purgeRequest=false` wird nicht unterstützt. 
+  Die API ist asynchron und gibt eine Transaktions-ID zurück, die über `CheckTransactionStatus` nachverfolgt werden kann. 

# CheckTransactionStatus
<a name="check-transaction-status"></a>


**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 \$1L273 | 

**Überlegungen**
+ Der Katalogpfadparameter muss dem im Abschnitt [Präfix- und Katalogpfadparameter](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) beschriebenen Stil entsprechen.