# Amazon SageMaker Unified Studio で S3 Tables のクエリを実行する方法
<a name="s3-tables-integrating-sagemaker"></a>

Amazon SageMaker Unified Studio は、SQL、自然言語、インタラクティブノートブックを使用してデータからインサイトをクエリおよび取得できる包括的な分析サービスです。統合されたインターフェイス内で、AWS データリポジトリとサードパーティーソース間のチームコラボレーションと分析ワークフローをサポートします。SageMaker Unified Studio は S3 Tables と直接統合されるため、Amazon S3 コンソール内でデータストレージから分析にシームレスに移行できます。

S3 Tables を SageMaker Unified Studio と統合するには、Amazon S3 コンソールまたは SageMaker Unified Studio コンソールを使用します。

SageMaker Unified Studio コンソールを使用したセットアップについては、「[SageMaker Unified Studio のドキュメント](https://docs.aws.amazon.com/next-generation-sagemaker/latest/userguide/s3-tables-integration.html)」を参照してください。

## SageMaker Unified Studio で S3 Tables をクエリするための要件
<a name="sagemaker-unified-studio-requirements"></a>

SageMaker Unified Studio を S3 Tables で使用するには、以下が必要です。
+ テーブルバケットは、現在のリージョンの AWS 分析サービスと統合されています。詳細については、「[S3 Tables と AWS 分析サービスの統合](s3-tables-integrating-aws.md)」を参照してください。
+ SageMaker Unified Studio でリソースを作成および表示するためのアクセス許可を持つ IAM ロールを使用している。詳細については、「[SageMaker Unified Studio での IAM ベースドメインのセットアップ](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/adminguide/setup-iam-based-domains.html)」を参照してください。
+ SageMaker ドメインとプロジェクトがある。詳細については、「*SageMaker Unified Studio 管理者ガイド*」の「[ドメイン](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/adminguide/working-with-domains.html)」および「*SageMaker Unified Studio ユーザーガイド*」の「[プロジェクト](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/projects.html)」を参照してください。

これらのアクションをまだ実行していない場合や、これらのリソースを作成していない場合は、S3 Tables によって自動的にセットアップが完了し、SageMaker Unified Studio でクエリを開始できるようになります。

## SageMaker Unified Studio で S3 Tables のクエリを実行する方法
<a name="sagemaker-unified-studio-getting-started"></a>

1.  で Amazon S3 コンソールを開きます[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. 左側のナビゲーションペインで、**[テーブルバケット]** を選択します。

1. **[テーブルバケット]** ページで、クエリを実行するテーブルを含むバケットを選択します。

1. バケットの詳細ページで、クエリするテーブルを選択します。

1. [**クエリ**] を選択します。

1. 次に、**[SageMaker Unified Studio のクエリテーブル]** を選択します。

   1. テーブルに SageMaker Unified Studio を既に設定している場合は、SageMaker Unified Studio コンソールがクエリエディタを開き、サンプル `SELECT` クエリがロードされます。必要に応じて、このクエリをユースケースに合わせて変更します。

   1. S3 Tables 用の SageMaker Unified Studio をまだ設定していない場合は、AWS 分析サービスとの統合を有効にする単一のステップを含むセットアップページが表示され、テーブルが SageMaker Unified Studio などのサービスと統合されます。このステップは自動的に実行され、SageMaker Unified Studio コンソールのページにリダイレクトされます。次のオプションを使用して、S3 Tables をクエリするためのアカウントを設定します。

      1. **[管理者としての設定]** で、現在のフェデレーション IAM ロールが選択されます。現在のロールに必要なアクセス許可がまだない場合は、[SageMaker Unified Studio で IAM ベースドメインをセットアップ](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/adminguide/setup-iam-based-domains.html)し、SageMaker Unified Studio にログインできるようにロールにアクセス許可を割り当てる必要があります。

      1. **[プロジェクトデータと管理制御]** で、**[必要なアクセス許可を持つ新しいロールを自動作成]** を選択して、必要なアクセス許可を持つロールを自動的に作成するか、**[既存のロールを使用]** を選択して、ロールを選択します。選択したロールに必要なアクセス許可がまだない場合は、[SageMaker Unified Studio で IAM ベースドメインを設定](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/adminguide/setup-iam-based-domains.html)し、SageMaker Unified Studio のデータにアクセスできるように管理者実行ロールにアクセス許可を割り当てる必要があります。

      1. **[データ暗号化]** で、AWS がキーを所有および管理できるようにするには、**[AWS 所有のキーを使用]** を選択し、既存のキーを使用するか新しいキーを作成するには、**[別の AWS AWS KMS キーを選択する (詳細)]** を選択します。

      1. **[SageMaker Unified Studio をセットアップ]** を選択します。

      1. 次に、SageMaker Unified Studio コンソールが開き、サンプル `SELECT` クエリがロードされたクエリエディタが表示されます。必要に応じて、このクエリをユースケースに合わせて変更します。

         クエリエディタで、**[カタログ]** フィールドに `s3tablescatalog/` に続いてテーブルバケットの名前を入力します。例えば、`s3tablescatalog/amzn-s3-demo-table-bucket` のようになります。**[データベース]** フィールドには、テーブルが保存されている名前空間が入力されます。