AWS Glue Iceberg REST 에 대한 카탈로그 통합 구성하기¶

1단계: AWS Glue Data Catalog에 대한 액세스 허가 구성¶

AWS Glue 데이터 카탈로그에 액세스하기 위해 Snowflake에 대한 IAM 정책을 만듭니다. 카탈로그 통합을 만들 때 지정하는 IAM 역할에 정책을 첨부합니다. 지침은 AWS Identity and Access Management 사용자 가이드에서 IAM 정책 만들기 및 역할 권한 정책 수정하기 를 참조하십시오.

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Sid": "AllowGlueCatalogTableAccess",
         "Effect": "Allow",
         "Action": [
           "glue:GetCatalog",
           "glue:GetDatabase",
           "glue:GetDatabases",
           "glue:GetTable",
           "glue:GetTables"
         ],
         "Resource": [
            "arn:aws:glue:*:<accountid>:table/*/*",
            "arn:aws:glue:*:<accountid>:catalog",
            "arn:aws:glue:*:<accountid>:database/<database-name>"
         ]
      }
   ]
}

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowGlueCatalogTableAccess",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "glue:GetCatalog",
        "glue:GetDatabase",
        "glue:GetDatabases",
        "glue:CreateDatabase",
        "glue:DeleteDatabase",
        "glue:GetTable",
        "glue:GetTables",
        "glue:CreateTable",
        "glue:UpdateTable",
        "glue:DeleteTable"
      ],
      "Resource": [
        "arn:aws:glue:*:<accountid>:table/*/*",
        "arn:aws:glue:*:<accountid>:catalog",
        "arn:aws:glue:*:<accountid>:database/*",
        "arn:aws:s3:<external_volume_path>"
      ]
    }
  ]
}

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "lakeformation:GetDataAccess",
            "Resource": "*"
        }
    ]
}

2단계: Snowflake에서 카탈로그 통합 만들기¶

CREATE CATALOG INTEGRATION(Apache Iceberg™ REST) ​명령을 사용하여 `AWS Glue Iceberg REST 엔드포인트<https://docs.aws.amazon.com/glue/latest/dg/connect-glu-iceberg-rest.html>`_에 대한 카탈로그 통합을 생성합니다. 구성한 IAM 역할을 지정합니다. :code:`CATALOG_NAME`에 AWS 계정 ID를 사용합니다.

CREATE CATALOG INTEGRATION glue_rest_catalog_int
  CATALOG_SOURCE = ICEBERG_REST
  TABLE_FORMAT = ICEBERG
  CATALOG_NAMESPACE = 'rest_catalog_integration'
  REST_CONFIG = (
    CATALOG_URI = 'https://glue.us-west-2.amazonaws.com/iceberg'
    CATALOG_API_TYPE = AWS_GLUE
    CATALOG_NAME = '123456789012'
  )
  REST_AUTHENTICATION = (
    TYPE = SIGV4
    SIGV4_IAM_ROLE = 'arn:aws:iam::123456789012:role/my-role'
    SIGV4_SIGNING_REGION = 'us-west-2'
  )
  ENABLED = TRUE;

여기서

• CATALOG_URI 는 AWS Glue Iceberg REST 카탈로그의 서비스 엔드포인트입니다.

• CATALOG_NAME 은 AWS 계정의 ID 입니다.

자세한 내용은 AWS Glue에 대한 카탈로그 통합 구성 지침이 포함된 CREATE CATALOG INTEGRATION(Apache Iceberg™ REST) 섹션을 참조하십시오.

3단계: Snowflake 계정에 대한 AWS IAM 사용자 및 외부 ID 검색¶

Snowflake 계정의 AWS IAM 사용자 및 외부 ID 정보를 검색하려면 DESCRIBE CATALOG INTEGRATION 명령을 실행합니다. 다음 단계에서 이 정보를 AWS에 제공하여 신뢰 관계를 구축합니다.

DESCRIBE CATALOG INTEGRATION glue_rest_catalog_int;

다음 값을 기록합니다.

값	설명
GLUE_AWS_IAM_USER_ARN	Snowflake 계정용으로 생성된 AWS IAM 사용자입니다(예: arn:aws:iam::123456789001:user/abc1-b-self1234). Snowflake는 전체 Snowflake 계정에 대해 단일 IAM 사용자를 프로비저닝합니다. 계정의 모든 Glue 카탈로그 통합에서 해당 IAM 사용자를 사용합니다.
GLUE_AWS_EXTERNAL_ID	신뢰 관계를 설정하기 위한 외부 ID입니다.

See moreShow less

Expand

4단계: AWS Glue 데이터 카탈로그에 대한 IAM 사용자 액세스 권한 부여¶

카탈로그 통합을 생성할 때 ()을 사용하여 지정한 것과 IAM동일한ARN GLUE_AWS_ROLE_ARN 역할에 대한 신뢰 정책을 업데이트합니다. 이전 단계에서 기록한 값을 신뢰 정책에 추가합니다.

지침은 신뢰 정책 수정하기 를 참조하십시오.

다음 예시 정책은 GLUE_AWS_IAM_USER_ARN 및 GLUE_AWS_EXTERNAL_ID 값을 지정할 위치를 보여줍니다.

{
   "Version": "2012-10-17",
   "Statement": [
      {
      "Sid": "",
      "Effect": "Allow",
      "Principal": {
         "AWS": "<glue_iam_user_arn>"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
         "StringEquals": {
            "sts:ExternalId": "<glue_aws_external_id>"
         }
      }
      }
   ]
}

여기서

• glue_iam_user_arn 은 자신이 기록한 GLUE_IAM_USER_ARN 값입니다.

• glue_aws_external_id 는 자신이 기록한 GLUE_AWS_EXTERNAL_ID 값입니다.

다음 단계¶

AWS Glue Iceberg REST에 대한 카탈로그 통합을 구성한 후 :doc:`카탈로그 연결 데이터베이스를 생성 </user-guide/tables-iceberg-catalog-linked-database>`할 수 있습니다. 카탈로그 연결 데이터베이스를 생성할 때 카탈로그 통합의 이름을 카탈로그로 지정합니다.

카탈로그 연결 데이터베이스는 원격 카탈로그의 네임스페이스 및 테이블을 자동으로 검색하고 동기화하여 원격 Iceberg REST 카탈로그에서 Snowflake로 외부 데이터를 가져옵니다.