AWS Glue Iceberg REST のカタログ統合の構成¶

ステップ1:AWSGlueデータカタログのアクセス許可を構成する¶

Snowflakeが AWS Glueデータカタログにアクセスするための IAM ポリシーを作成します。カタログ統合を作成するときに指定する IAM ロールにポリシーを添付します。手順については、 AWS IDおよびアクセス管理ユーザーガイドの 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でカタログ統合を作成する¶

` コマンドを使用して、 AWS REST Glue Iceberg <https://docs.aws.amazon.com/glue/latest/dg/connect-glu-iceberg-rest.html> エンドポイント _:doc:/sql-reference/sql/create-catalog-integration-rest` のカタログ統合を作成します。構成した IAM ロールを指定します。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 です。

詳細情報については、 CREATE CATALOG INTEGRATION （Apache Iceberg™ REST） を参照してください。AWS Glue 用のカタログ統合の構成手順が記載されています。

ステップ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：IAM ユーザーに AWS Glue Data Catalogへのアクセス権限を付与します。¶

カタログ統合の作成時に :emph:` で指定したの 同じIAM ARN ロールの信頼ポリシーを更新します（:code:`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に外部データを取り込みます。