이 섹션에는 AWS Glue Iceberg REST 카탈로그 및 AWS Glue 익스텐션 API에 대한 사양과 이러한 API를 사용할 때의 고려 사항이 포함되어 있습니다.
AWS Glue Data Catalog 엔드포인트에 대한 API 요청은 AWS Signature Version 4(SigV4)를 사용하여 인증됩니다. AWS SigV4에 대한 자세한 내용은 API 요청용 AWS Signature Version 4 섹션을 참조하세요.
AWS Glue 서비스 엔드포인트 및 AWS Glue 메타데이터에 액세스할 때 애플리케이션은 IAM 작업이 필요한 glue:getCatalog IAM 역할을 수임합니다.
Data Catalog 및 해당 객체에 대한 액세스는 IAM, Lake Formation 또는 Lake Formation 하이브리드 모드 권한을 사용하여 관리할 수 있습니다.
Data Catalog의 페더레이션 카탈로그에는 Lake Formation에 등록된 데이터 위치가 있습니다. Lake Formation은 Data Catalog와 연동하며 Data Catalog 객체에 대한 사용자 액세스를 관리할 수 있는 데이터베이스 스타일 권한을 제공합니다.
IAM, AWS Lake Formation 또는 Lake Formation 하이브리드 모드 권한을 사용하여 기본 Data Catalog 및 해당 객체에 대한 액세스를 관리할 수 있습니다.
Lake Formation 관리형 객체에서 데이터를 생성, 삽입 또는 삭제하려면 IAM 사용자 또는 역할에 대한 권한을 설정해야 합니다.
-
CREATE_CATALOG – 카탈로그를 생성하는 데 필요합니다.
-
CREATE_DATABASE – 데이터베이스를 생성하는 데 필요합니다.
-
CREATE_TABLE – 테이블을 생성하는 데 필요합니다.
-
DELETE - 테이블에서 데이터를 삭제하는 데 필요합니다.
-
DESCRIBE - 메타데이터를 읽는 데 필요합니다.
-
DROP - 테이블 또는 데이터베이스를 삭제하는 데 필요합니다.
-
INSERT - 위탁자가 테이블에 데이터를 삽입해야 할 때 필요합니다.
-
SELECT - 위탁자가 테이블에서 데이터를 선택해야 할 때 필요합니다.
자세한 내용은 AWS Lake Formation 개발자 가이드에서 Lake Formation 권한 참조를 참조하세요.
| 작업 이름 | GetConfig |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
GET /iceberg/v1/config |
| IAM 작업 |
glue:GetCatalog |
| Lake Formation 권한 | 해당 사항 없음 |
| CloudTrail 이벤트 |
glue:GetCatalog |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L67 |
고려 사항 및 제한 사항
-
warehouse쿼리 파라미터는 AWS Glue 카탈로그 ID로 설정해야 합니다. 설정하지 않을 경우 현재 계정의 루트 카탈로그가 응답을 반환하는 데 사용됩니다. 자세한 내용은 접두사 및 카탈로그 경로 파라미터 단원을 참조하십시오.
| 작업 이름 | GetCatalog |
| 유형 |
AWS Glue 익스텐션 API |
| REST 경로 |
GET/extensions/v1/catalogs/{catalog} |
| IAM 작업 |
glue:GetCatalog |
| Lake Formation 권한 | DESCRIBE |
| CloudTrail 이벤트 |
glue:GetCatalog |
| API 정의 열기 | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L40 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
| 작업 이름 | ListNamespaces |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
GET/iceberg/v1/catalogs/{catalog}/namespaces |
| IAM 작업 |
glue:GetDatabase |
| Lake Formation 권한 | ALL, DESCRIBE, SELECT |
| CloudTrail 이벤트 |
glue:GetDatabase |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L205 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
-
그 다음 수준의 네임스페이스만 표시됩니다. 네임스페이스를 더 깊은 수준에서 나열하려면 카탈로그 경로 파라미터에 중첩 카탈로그 ID를 지정합니다.
| 작업 이름 | CreateNamespace |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
POST/iceberg/v1/catalogs/{catalog}/namespaces |
| IAM 작업 |
glue:CreateDatabase |
| Lake Formation 권한 | ALL, DESCRIBE, SELECT |
| CloudTrail 이벤트 |
glue:CreateDatabase |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L256 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
-
단일 수준 네임스페이스만 생성할 수 있습니다. 다중 수준 네임스페이스를 생성하려면 각 수준을 반복적으로 생성하고 카탈로그 경로 파라미터를 사용하여 해당 수준에 연결해야 합니다.
| 작업 이름 | StartCreateNamespaceTransaction |
| 유형 |
AWS Glue 익스텐션 API |
| REST 경로 |
POST/extensions/v1/catalogs/{catalog}/namespaces |
| IAM 작업 |
glue:CreateDatabase |
| Lake Formation 권한 | ALL, DESCRIBE, SELECT |
| CloudTrail 이벤트 |
glue:CreateDatabase |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L256 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
-
단일 수준 네임스페이스만 생성할 수 있습니다. 다중 수준 네임스페이스를 생성하려면 각 수준을 반복적으로 생성하고 카탈로그 경로 파라미터를 사용하여 해당 수준에 연결해야 합니다.
-
이 API는 비동기식이며
CheckTransactionStatusAPI 직접 호출을 사용하여 추적하는 데 사용할 수 있는 트랜잭션 ID를 반환합니다. -
GetCatalogAPI 직접 호출의 응답에use-extensions=true파라미터가 포함된 경우에만 이 API를 직접적으로 호출할 수 있습니다.
| 작업 이름 | LoadNamespaceMetadata |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns} |
| IAM 작업 |
glue:GetDatabase |
| Lake Formation 권한 | ALL, DESCRIBE, SELECT |
| CloudTrail 이벤트 |
glue:GetDatabase |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L302 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
| 작업 이름 | UpdateNamespaceProperties |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/properties |
| IAM 작업 |
glue:UpdateDatabase |
| Lake Formation 권한 | ALL, ALTER |
| CloudTrail 이벤트 |
glue:UpdateDatabase |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L400 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
| 작업 이름 | DeleteNamespace |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
DELETE/iceberg/v1/catalogs/{catalog}/namespces/{ns} |
| IAM 작업 |
glue:DeleteDatabase |
| Lake Formation 권한 | ALL, DROP |
| CloudTrail 이벤트 |
glue:DeleteDatabase |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L365 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
데이터베이스에 객체가 존재할 경우, 해당 작업은 실패합니다.
-
이 API는 비동기식이며
CheckTransactionStatusAPI 직접 호출을 사용하여 추적하는 데 사용할 수 있는 트랜잭션 ID를 반환합니다. -
GetCatalogAPI 직접 호출이 응답으로use-extensions=true를 나타내는 경우에만 이 API를 사용할 수 있습니다.
| 작업 이름 | StartDeleteNamespaceTransaction |
| 유형 |
AWS Glue 익스텐션 API |
| REST 경로 |
DELETE /extensions/v1/catalogs/{catalog}/namespces/{ns} |
| IAM 작업 |
glue:DeleteDatabase |
| Lake Formation 권한 | ALL, DROP |
| CloudTrail 이벤트 |
glue:DeleteDatabase |
| API 정의 열기 | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L85 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
데이터베이스에 객체가 존재할 경우, 해당 작업은 실패합니다.
-
이 API는 비동기식이며
CheckTransactionStatusAPI 직접 호출을 사용하여 추적하는 데 사용할 수 있는 트랜잭션 ID를 반환합니다. -
GetCatalogAPI 직접 호출이 응답으로use-extensions=true를 나타내는 경우에만 이 API를 사용할 수 있습니다.
| 작업 이름 | ListTables |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| IAM 작업 |
glue:GetTables |
| Lake Formation 권한 | ALL, SELECT, DESCRIBE |
| CloudTrail 이벤트 |
glue:GetTables |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L463 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
Iceberg가 아닌 테이블을 포함한 모든 테이블이 나열됩니다. 테이블을 Iceberg 테이블로 로드할 수 있는지 여부를 확인하려면
LoadTable작업을 직접적으로 호출합니다.
| 작업 이름 | CreateTable |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| IAM 작업 |
glue:CreateTable |
| Lake Formation 권한 | ALL, CREATE_TABLE |
| CloudTrail 이벤트 |
glue:CreateTable |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L497 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
스테이징이 포함된
CreateTable은 지원되지 않습니다.stageCreate쿼리 파라미터를 지정하면 작업이 실패합니다. 즉,CREATE TABLE AS SELECT와 같은 작업은 지원되지 않으며, 해결 방법으로CREATE TABLE및INSERT INTO의 조합을 사용할 수 있습니다. -
CreateTableAPI 작업은state-create = TRUE옵션을 지원하지 않습니다.
| 작업 이름 | CreateTable |
| 유형 |
AWS Glue 익스텐션 API |
| REST 경로 |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables |
| IAM 작업 |
glue:CreateTable |
| Lake Formation 권한 | ALL, CREATE_TABLE |
| CloudTrail 이벤트 |
glue:CreateTable |
| API 정의 열기 | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L107 |
고려 사항 및 제한 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
스테이징이 포함된
CreateTable은 지원되지 않습니다.stageCreate쿼리 파라미터를 지정하면 작업이 실패합니다. 즉,CREATE TABLE AS SELECT와 같은 작업은 지원되지 않으며, 해결 방법으로CREATE TABLE및INSERT INTO의 조합을 사용해야 합니다. -
이 API는 비동기식이며
CheckTransactionStatusAPI 직접 호출을 사용하여 추적하는 데 사용할 수 있는 트랜잭션 ID를 반환합니다. -
GetCatalogAPI 직접 호출이 응답으로use-extensions=true를 나타내는 경우에만 이 API를 사용할 수 있습니다.
| 작업 이름 | LoadTable |
| 유형 |
AWS Glue 익스텐션 API |
| REST 경로 |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| IAM 작업 |
glue:GeTTable |
| Lake Formation 권한 | ALL, SELECT, DESCRIBE |
| CloudTrail 이벤트 |
glue:GetTable |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L616 |
고려 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
스테이징이 포함된
CreateTable은 지원되지 않습니다.stageCreate쿼리 파라미터를 지정하면 작업이 실패합니다. 즉,CREATE TABLE AS SELECT와 같은 작업은 지원되지 않으며, 해결 방법으로CREATE TABLE및INSERT INTO의 조합을 사용해야 합니다. -
이 API는 비동기식이며
CheckTransactionStatusAPI 직접 호출을 사용하여 추적하는 데 사용할 수 있는 트랜잭션 ID를 반환합니다. -
GetCatalogAPI 직접 호출이 응답으로use-extensions=true를 나타내는 경우에만 이 API를 사용할 수 있습니다.
| 작업 이름 | LoadTable |
| 유형 |
AWS Glue 익스텐션 API |
| REST 경로 |
GET /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| IAM 작업 |
glue:GetTable |
| Lake Formation 권한 | ALL, SELECT, DESCRIBE |
| CloudTrail 이벤트 |
glue:GetTable |
| API 정의 열기 | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L134 |
고려 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
스냅샷 쿼리 파라미터에는
all모드만 지원됩니다. -
LoadTableAPI와 비교하여ExtendedLoadTableAPI는 다음과 같은 측면에서 다릅니다.모든 필드를 사용할 수 있도록 엄격하게 강제하지는 않습니다.
-
응답의 구성 필드에 다음과 같은 추가 파라미터를 제공합니다.
추가 파라미터 Config 키 설명 aws.server-side-capabilities.scan-planning
PreparePlan 테이블 및 PlanTable API를 사용하여 테이블을 스캔할 수 있는지 여부를 나타냅니다. aws.server-side-capabilities.data-commit
StartUpdateTable 트랜잭션을 사용하여 테이블을 커밋할 수 있는지 여부를 나타냅니다. aws.glue.staging.location
엔진이 임시 데이터 파일을 작성하는 데 사용할 수 있는 서비스 관리형 스테이징 위치이며 서버 측 스캔 계획 또는 데이터 커밋에 사용됩니다.
aws.glue.staging.access-key-id
서비스 관리형 스테이징 위치에 액세스하기 위한 임시 AWS 자격 증명의 일부이며 서버 측 스캔 계획 또는 데이터 커밋에 사용됩니다.
aws.glue.staging.secret-access-key
서비스 관리형 스테이징 위치에 액세스하기 위한 임시 AWS 자격 증명의 일부이며 서버 측 스캔 계획 또는 데이터 커밋에 사용됩니다.
aws.glue.staging.session-token
서비스 관리형 스테이징 위치에 액세스하기 위한 임시 AWS 자격 증명의 일부이며 서버 측 스캔 계획 또는 데이터 커밋에 사용됩니다.
aws.glue.staging.expiration-ms
서비스 관리형 스테이징 위치에 액세스하기 위한 임시 자격 증명의 만료 시간이며 서버 측 스캔 계획 또는 데이터 커밋에 사용됩니다.
aws.glue.staging.data-transfer-role-arn
서비스 관리형 스테이징 위치에 액세스하기 위해 수임할 수 있는 IAM 역할이며 서버 측 스캔 계획 또는 데이터 커밋에 사용됩니다.
| 작업 이름 | PreplanTable |
| 유형 |
AWS Glue 익스텐션 API |
| REST 경로 |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/preplan |
| IAM 작업 |
glue:GetTable |
| Lake Formation 권한 | ALL, SELECT, DESCRIBE |
| CloudTrail 이벤트 |
glue:GetTable |
| API 정의 열기 | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L211 |
고려 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
이 API의 호출자는 항상 페이지 토큰을 기반으로 가져올 나머지 결과가 있는지 확인해야 합니다. 서버 측이 아직 처리 중이지만 지정된 응답 시간 내에 결과를 생성할 수 없는 경우 빈 페이지 항목이 있지만 페이지 매김 토큰이 있는 응답이 가능합니다.
-
ExtendedLoadTableAPI 응답에aws.server-side-capabilities.scan-planning=true가 포함된 경우에만 이 API를 사용할 수 있습니다.
| 작업 이름 | PlanTable |
| 유형 |
AWS Glue 익스텐션 API |
| REST 경로 |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/plan |
| IAM 작업 |
glue:GetTable |
| Lake Formation 권한 | ALL, SELECT, DESCRIBE |
| CloudTrail 이벤트 |
glue:GetTable |
| API 정의 열기 | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L243 |
고려 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
이 API의 호출자는 항상 페이지 토큰을 기반으로 가져올 나머지 결과가 있는지 확인해야 합니다. 서버 측이 아직 처리 중이지만 지정된 응답 시간 내에 결과를 생성할 수 없는 경우 빈 페이지 항목이 있지만 페이지 매김 토큰이 있는 응답이 가능합니다.
-
ExtendedLoadTableAPI 응답에aws.server-side-capabilities.scan-planning=true가 포함된 경우에만 이 API를 사용할 수 있습니다.
| 작업 이름 | TableExists |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
HEAD/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| IAM 작업 |
glue:GetTable |
| Lake Formation 권한 | ALL, SELECT, DESCRIBE |
| CloudTrail 이벤트 |
glue:GetTable |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L833 |
고려 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
| 작업 이름 | UpdateTable |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| IAM 작업 |
glue:UpdateTable |
| Lake Formation 권한 | ALL, ALTER |
| CloudTrail 이벤트 |
glue:UpdateTable |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L677 |
고려 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
| 작업 이름 | StartUpdateTableTransaction |
| 유형 | AWS Glue 익스텐션 API |
| REST 경로 |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| IAM 작업 |
glue:UpdateTable |
| Lake Formation 권한 |
ALL, ALTER |
| CloudTrail 이벤트 |
glue:UpdateTable |
| API 정의 열기 | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L154 |
고려 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
이 API는 비동기식이며
CheckTransactionStatusAPI 직접 호출을 사용하여 추적하는 데 사용할 수 있는 트랜잭션 ID를 반환합니다. -
이 API를 통해
RenamTable작업을 수행할 수도 있습니다. 이 경우 호출자는 이름을 바꿀 테이블에 대한 glue:CreateTable 또는 LakeFormation CREATE_TABLE 권한도 얻어야 합니다. -
ExtendedLoadTableAPI 응답에aws.server-side-capabilities.scan-planning=true가 포함된 경우에만 이 API를 사용할 수 있습니다.
| 작업 이름 | DeleteTable |
| 유형 |
Iceberg REST 카탈로그 API |
| REST 경로 |
DELETE/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| IAM 작업 |
glue:DeleteTable |
| Lake Formation 권한 | ALL, DROP |
| CloudTrail 이벤트 |
glue:DeleteTable |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L793 |
고려 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
DeleteTableAPI 작업은 제거 옵션을 지원합니다. 제거를true로 설정하면 테이블 데이터가 삭제되고, 그렇지 않으면 데이터가 삭제되지 않습니다. Amazon S3의 테이블에서는 이 작업을 실행해도 테이블 데이터가 삭제되지 않습니다. 테이블이 Amazon S3 및purge = TRUE,에 저장되어 있는 경우 이 작업이 실패합니다.Amazon Redshift 관리형 스토리지에 저장된 테이블의 경우 이 작업은 Amazon Redshift의
DROP TABLE동작과 마찬가지로 테이블 데이터를 삭제합니다. 테이블이 Amazon Redshift 및purge = FALSE에 저장되어 있는 경우 이 작업이 실패합니다. -
purgeRequest=true는 지원되지 않습니다.
| 작업 이름 | StartDeleteTableTransaction |
| 유형 |
AWS Glue 익스텐션 API |
| REST 경로 |
DELETE /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table} |
| IAM 작업 |
glue:DeleteTable |
| Lake Formation 권한 | ALL, DROP |
| CloudTrail 이벤트 |
glue:DeleteTable |
| API 정의 열기 | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest-catalog-open-api.yaml#L793 |
고려 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
REST 경로 파라미터에는 단일 수준 네임스페이스만 지정할 수 있습니다. 자세한 내용은 네임스페이스 경로 파라미터 섹션을 참조하세요.
-
purgeRequest=false는 지원되지 않습니다. -
이 API는 비동기식이며
CheckTransactionStatus를 통해 추적할 수 있는 트랜잭션 ID를 반환합니다.
| 작업 이름 | CheckTransactionStatus |
| 유형 |
AWS Glue 익스텐션 API |
| REST 경로 |
POST/extensions/v1/transactions/status |
| IAM 작업 |
트랜잭션을 시작하는 작업과 동일한 권한 |
| Lake Formation 권한 | 트랜잭션을 시작하는 작업과 동일한 권한 |
| API 정의 열기 | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-extensions-api.yaml#L273 |
고려 사항
-
카탈로그 경로 파라미터는 접두사 및 카탈로그 경로 파라미터 섹션에 설명된 스타일을 따라야 합니다.
