# APIs REST do AWS Glue para especificações do Apache Iceberg
<a name="iceberg-rest-apis"></a>

Esta seção contém especificações sobre o catálogo REST do AWS Glue para Iceberg e as APIs de extensão do AWS Glue, além de considerações sobre o uso dessas APIs. 

As solicitações de API aos endpoints do AWS Glue Data Catalog são autenticadas por meio do AWS Signature Version 4 (SigV4). Consulte a seção [AWS Signature Version 4 para solicitações de API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) para saber mais sobre o AWS SigV4.

Ao acessar o endpoint de serviço do AWS Glue e os metadados do AWS Glue, a aplicação assume um perfil do IAM que exige uma ação `glue:getCatalog` do IAM. 

O acesso ao Catálogo de Dados e seus objetos pode ser gerenciado usando permissões do IAM, Lake Formation ou modo híbrido do Lake Formation.

Os catálogos federados no Catálogo de Dados têm locais de dados registrados no Lake Formation. O Lake Formation trabalha com o Catálogo de Dados para fornecer permissões no estilo de banco de dados para gerenciar o acesso de usuários a objetos do Catálogo de Dados. 

É possível usar as permissões do IAM, do AWS Lake Formation ou do modo híbrido do Lake Formation para gerenciar o acesso ao Catálogo de Dados padrão e seus objetos. 

Para criar, inserir ou excluir dados em objetos gerenciados do Lake Formation, é necessário configurar permissões específicas para o usuário ou perfil do IAM. 
+ CREATE\$1CATALOG: necessária para criar catálogos 
+ CREATE\$1DATABASE: necessária para criar bancos de dados
+ CREATE\$1TABLE: necessária para criar tabelas
+ DELETE: necessária para excluir dados de uma tabela
+ DESCRIBE: necessária para ler metadados 
+ DROP: necessária para descartar/excluir uma tabela ou banco de dados
+ INSERT: necessária quando a entidade principal precisa inserir dados em uma tabela
+ SELECT: necessária quando a entidade principal precisa selecionar dados de uma tabela

Para obter mais informações, consulte [Referência de permissões do Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/lf-permissions-reference.html) no Guia do desenvolvedor do AWS Lake Formation.

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | GetConfig | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  GET /iceberg/v1/config  | 
| Ação do IAM |  glue:GetCatalog  | 
| Permissões do Lake Formation | Não aplicável | 
| Evento do CloudTrail |  glue:GetCatalog  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L67 | 

****Considerações e limitações****
+ O parâmetro da consulta `warehouse` deve ser definido como o ID do catálogo do AWS Glue. Caso não tenha sido definido, o catálogo raiz na conta atual será usado para retornar a resposta. Para obter mais informações, consulte [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | GetCatalog | 
| Tipo |  API de extensão do AWS Glue  | 
| Caminho REST |  GET/extensions/v1/catalogs/\$1catalog\$1  | 
| Ação do IAM |  glue:GetCatalog  | 
| Permissões do Lake Formation | DESCRIBE | 
| Evento do CloudTrail |  glue:GetCatalog  | 
| Definição da Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml\$1L40 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | ListNamespaces | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  GET/iceberg/v1/catalogs/\$1catalog\$1/namespaces  | 
| Ação do IAM |  glue:GetDatabase  | 
| Permissões do Lake Formation | ALL, DESCRIBE, SELECT | 
| Evento do CloudTrail |  glue:GetDatabase  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L205 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Somente os namespaces do próximo nível são exibidos. Para listar namespaces em níveis mais profundos, especifique o ID do catálogo aninhado no parâmetro do caminho do catálogo.

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | CreateNamespace | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  POST/iceberg/v1/catalogs/\$1catalog\$1/namespaces  | 
| Ação do IAM |  glue:CreateDatabase  | 
| Permissões do Lake Formation | ALL, DESCRIBE, SELECT | 
| Evento do CloudTrail |  glue:CreateDatabase  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L256 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ Somente um namespace de nível único pode ser criado. Para criar um namespace de vários níveis, é necessário criar iterativamente cada nível e se conectarao nível usando o parâmetro de caminho do catálogo.

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | StartCreateNamespaceTransaction | 
| Tipo |  API de extensões do AWS Glue  | 
| Caminho REST |  POST/extensions/v1/catalogs/\$1catalog\$1/namespaces  | 
| Ação do IAM |  glue:CreateDatabase  | 
| Permissões do Lake Formation | ALL, DESCRIBE, SELECT | 
| Evento do CloudTrail |  glue:CreateDatabase  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L256 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível criar somente um namespace de nível único. Para criar namespaces de vários níveis, é necessário criar cada nível de forma iterativa e conectar-se ao nível usando o parâmetro de caminho do catálogo.
+ A API é assíncrona e retorna um ID de transação que você pode usar para rastreamento usando a chamada de API `CheckTransactionStatus`.
+  Você poderá chamar essa API somente se a chamada de API `GetCatalog` contiver o parâmetro `use-extensions=true` na resposta. 

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | LoadNamespaceMetadata | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  GET/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1  | 
| Ação do IAM |  glue:GetDatabase  | 
| Permissões do Lake Formation | ALL, DESCRIBE, SELECT | 
| Evento do CloudTrail |  glue:GetDatabase  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L302 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | UpdateNamespaceProperties | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  POST /iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/properties  | 
| Ação do IAM |  glue:UpdateDatabase  | 
| Permissões do Lake Formation | ALL, ALTER | 
| Evento do CloudTrail |  glue:UpdateDatabase  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L400 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | DeleteNamespace | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  DELETE/iceberg/v1/catalogs/\$1catalog\$1/namespces/\$1ns\$1  | 
| Ação do IAM |  glue:DeleteDatabase  | 
| Permissões do Lake Formation | ALL, DROP | 
| Evento do CloudTrail |  glue:DeleteDatabase  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L365 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ Se houver objetos no banco de dados, a operação falhará.
+ A API é assíncrona e retorna um ID de transação que você pode usar para rastreamento usando a chamada de API `CheckTransactionStatus`.
+  A API só poderá ser usada se a chamada de API `GetCatalog` indicar `use-extensions=true` na resposta. 

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | StartDeleteNamespaceTransaction | 
| Tipo |  API de extensões do AWS Glue  | 
| Caminho REST |  DELETE /extensions/v1/catalogs/\$1catalog\$1/namespces/\$1ns\$1  | 
| Ação do IAM |  glue:DeleteDatabase  | 
| Permissões do Lake Formation | ALL, DROP | 
| Evento do CloudTrail |  glue:DeleteDatabase  | 
| Definição da Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml\$1L85 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ Se houver objetos no banco de dados, a operação falhará.
+ A API é assíncrona e retorna um ID de transação que você pode usar para rastreamento usando a chamada de API `CheckTransactionStatus`.
+  A API só poderá ser usada se a chamada de API `GetCatalog` indicar `use-extensions=true` na resposta. 

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | ListTables | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  GET /iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables  | 
| Ação do IAM |  glue:GetTables  | 
| Permissões do Lake Formation | ALL, SELECT, DESCRIBE | 
| Evento do CloudTrail |  glue:GetTables  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L463 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ Todas as tabelas, incluindo tabelas não Iceberg, serão listadas. Para determinar se uma tabela pode ser carregada como uma tabela Iceberg ou não, chame a operação `LoadTable`.

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | CreateTable | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  GET /iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables  | 
| Ação do IAM |  glue:CreateTable  | 
| Permissões do Lake Formation | ALL, CREATE\$1TABLE | 
| Evento do CloudTrail |  glue:CreateTable  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L497 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ Não há suporte a `CreateTable` com preparação. Se o parâmetro de consulta `stageCreate` for especificado, a operação falhará. Isso significa que operações como `CREATE TABLE AS SELECT` não são permitidas, e você poderá usar uma combinação de `CREATE TABLE` e `INSERT INTO` como alternativa.
+ A operação `CreateTable` da API não oferece suporte à opção `state-create = TRUE`.

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | CreateTable | 
| Tipo |  API de extensões do AWS Glue  | 
| Caminho REST |  POST/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables  | 
| Ação do IAM |  glue:CreateTable  | 
| Permissões do Lake Formation | ALL, CREATE\$1TABLE | 
| Evento do CloudTrail |  glue:CreateTable  | 
| Definição da Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml\$1L107 | 

****Considerações e limitações****
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ Não há suporte a `CreateTable` com preparação. Se o parâmetro de consulta `stageCreate` for especificado, a operação falhará. Isso significa que não há suporte a operações como `CREATE TABLE AS SELECT`, e o usuário deve usar uma combinação de `CREATE TABLE` e `INSERT INTO` como solução alternativa.
+ A API é assíncrona e retorna um ID de transação que você pode usar para rastreamento usando a chamada de API `CheckTransactionStatus`.
+  A API só poderá ser usada se a chamada de API `GetCatalog` indicar `use-extensions=true` na resposta. 

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | LoadTable | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  GET /iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1  | 
| Ação do IAM |  glue:GetTable  | 
| Permissões do Lake Formation | ALL, SELECT, DESCRIBE | 
| evento do CloudTrail |  glue:GetTable  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L616 | 

**Considerações**
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ Não há suporte a `CreateTable` com preparação. Se o parâmetro de consulta `stageCreate` for especificado, a operação falhará. Isso significa que não há suporte a operações como `CREATE TABLE AS SELECT`, e o usuário deve usar uma combinação de `CREATE TABLE` e `INSERT INTO` como solução alternativa.
+ A API é assíncrona e retorna um ID de transação que você pode usar para rastreamento usando a chamada de API `CheckTransactionStatus`.
+  A API só poderá ser usada se a chamada de API `GetCatalog` indicar `use-extensions=true` na resposta. 

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | LoadTable | 
| Tipo |  API de extensões do AWS Glue  | 
| Caminho REST |  GET /extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1  | 
| Ação do IAM |  glue:GetTable  | 
| Permissões do Lake Formation | ALL, SELECT, DESCRIBE | 
| Evento do CloudTrail |  glue:GetTable  | 
| Definição da Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml\$1L134 | 

**Considerações**
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ Somente o modo `all` é suportado para o parâmetro de consulta de snapshots.
+ Em comparação com a API `LoadTable`, a API `ExtendedLoadTable` difere das seguintes formas:
  +  Não impõe estritamente que todos os campos estejam disponíveis.
  + Fornece os seguintes parâmetros adicionais no campo de configuração da resposta:   
**Parâmetros adicionais**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/glue/latest/dg/extended-load-table.html)

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | PreplanTable | 
| Tipo |  API de extensões do AWS Glue  | 
| Caminho REST |  POST /extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1/preplan  | 
| Ação do IAM |  glue:GetTable  | 
| Permissões do Lake Formation | ALL, SELECT, DESCRIBE | 
| Evento do CloudTrail |  glue:GetTable  | 
| Definição da Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml\$1L211 | 

**Considerações**
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ O chamador dessa API deve sempre determinar se ainda há resultados a serem buscados com base no token da página. Uma resposta com um item de página vazio, mas um token de paginação, será possível se o lado do servidor ainda estiver processando, mas não for capaz de produzir nenhum resultado no tempo de resposta determinado.
+  Você poderá usar essa API somente se a resposta da API `ExtendedLoadTable` contiver `aws.server-side-capabilities.scan-planning=true`. 

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | PlanTable | 
| Tipo |  API de extensões do AWS Glue  | 
| Caminho REST |  POST /extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1/plan  | 
| Ação do IAM |  glue:GetTable  | 
| Permissões do Lake Formation | ALL, SELECT, DESCRIBE | 
| Evento do CloudTrail |  glue:GetTable  | 
| Definição da Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml\$1L243 | 

**Considerações**
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ O chamador dessa API deve sempre determinar se ainda há resultados a serem buscados com base no token da página. Uma resposta com um item de página vazio, mas um token de paginação, será possível se o lado do servidor ainda estiver processando, mas não for capaz de produzir nenhum resultado no tempo de resposta determinado.
+  Você poderá usar essa API somente se a resposta da API `ExtendedLoadTable` contiver `aws.server-side-capabilities.scan-planning=true`. 

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | TableExists | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  HEAD/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1  | 
| Ação do IAM |  glue:GetTable  | 
| Permissões do Lake Formation | ALL, SELECT, DESCRIBE | 
| Evento do CloudTrail |  glue:GetTable  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L833 | 

**Considerações**
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | UpdateTable | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  POST /iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1  | 
| Ação do IAM |  glue:UpdateTable  | 
| Permissões do Lake Formation | ALL, ALTER | 
| Evento do CloudTrail |  glue:UpdateTable  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L677 | 

**Considerações**
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | StartUpdateTableTransaction | 
| Tipo | API de extensão do AWS Glue | 
| Caminho REST |  POST/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1  | 
| Ação do IAM |  glue:UpdateTable  | 
| Permissões do Lake Formation |  ALL, ALTER  | 
| Evento do CloudTrail |  glue:UpdateTable  | 
| Definição da Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml\$1L154 | 

**Considerações**
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ A API é assíncrona e retorna um ID de transação que você pode usar para rastreamento usando a chamada de API `CheckTransactionStatus`.
+  Uma operação `RenamTable` também pode ser executada por meio dessa API. Quando isso acontece, o chamador também deve ter a permissão glue:CreateTable ou CREATE\$1TABLE do LakeFormation para que a tabela seja renomeada. 
+  Você poderá usar essa API somente se a resposta da API `ExtendedLoadTable` contiver `aws.server-side-capabilities.scan-planning=true`. 

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | DeleteTable | 
| Tipo |  API do catálogo REST do Iceberg  | 
| Caminho REST |  DELETE/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1  | 
| Ação do IAM |  glue:DeleteTable  | 
| Permissões do Lake Formation | ALL, DROP | 
| Evento do CloudTrail |  glue:DeleteTable  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L793 | 

**Considerações**
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ A operação da API `DeleteTable` oferece suporte a uma opção de expurgo. Quando a limpeza é definida como `true`, os dados da tabela são excluídos, caso contrário, os dados não são excluídos. Para tabelas no Amazon S3, a operação não exclui dados da tabela. A operação falha quando a tabela está armazenada no Amazon S3 e `purge = TRUE,`. 

  Para tabelas que estão no armazenamento gerenciado do Amazon Redshift, a operação excluirá os dados da tabela, semelhante ao comportamento de `DROP TABLE` no Amazon Redshift. A operação falha quando a tabela está armazenada no Amazon Redshift e `purge = FALSE`.
+ Não há suporte ao `purgeRequest=true`. 

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | StartDeleteTableTransaction | 
| Tipo |  API de extensões do AWS Glue  | 
| Caminho REST |  DELETE /extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1  | 
| Ação do IAM |  glue:DeleteTable  | 
| Permissões do Lake Formation | ALL, DROP | 
| Evento do CloudTrail |  glue:DeleteTable  | 
| Definição da Open API | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml\$1L793 | 

**Considerações**
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).
+ É possível especificar somente um namespace de nível único no parâmetro REST Path. Para obter mais informações, consulte a seção [Parâmetro do caminho do namespace](connect-glu-iceberg-rest.md#ns-path-param).
+ Não há suporte ao `purgeRequest=false`. 
+  A API é assíncrona e retorna um ID de transação que pode ser rastreado via `CheckTransactionStatus`. 

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


**Informações gerais**  

|  |  | 
| --- |--- |
| Nome da operação | CheckTransactionStatus | 
| Tipo |  API de extensões do AWS Glue  | 
| Caminho REST |  POST/extensions/v1/transactions/status  | 
| Ação do IAM |  A mesma permissão da ação que inicia a transação  | 
| Permissões do Lake Formation | A mesma permissão da ação que inicia a transação | 
| Definição da Open API | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml\$1L273 | 

**Considerações**
+ O parâmetro do caminho do catálogo deve seguir o estilo descrito na seção [Parâmetros de prefixo e caminho do catálogo](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).