翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SQL 拡張機能を使用してデータを参照する
<a name="sagemaker-sql-extension-features-data-discovery"></a>

SQL 拡張機能のユーザーインターフェイス (UI) を開くには、Studio の JupyterLab アプリケーションのナビゲーションパインで、SQL 拡張機能アイコン (![](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/sqlexplorer/sqlexplorer-icon.png)) をクリックします。左パネルのデータ検出ビューを展開すると、Amazon Athena、Amazon Redshift、Snowflake への事前設定されたすべてのデータストア接続が表示されます。

そこから、以下を実行できます。
+ 特定の接続を展開して、データベース、スキーマ、テーブルまたはビュー、列を探索できます。
+ SQL 拡張機能 UI の検索ボックスを使用して、特定の接続を検索できます。このような検索は、入力した文字列に部分的に一致するデータベース、スキーマ、テーブル、またはビューを返します。

**注記**  
Athena が AWS アカウントで既に設定されている場合は、`default-athena-connection`JupyterLab アプリケーションで を有効にできます。これにより、接続を手動で作成しなくても Athena クエリを実行できます。デフォルトの Athena 接続を有効にするには:  
実行ロールに Athena と AWS Glue カタログにアクセスするために必要なアクセス許可があることを管理者に確認します。必要なアクセス許可の詳細については、「[Athena AWS Glue の接続を設定する](sagemaker-sql-extension-datasources-glue-connection.md#sagemaker-sql-extension-athena-glue-connection-config)」を参照してください。
JupyterLab アプリケーションで、上部ナビゲーションバーの **[設定]** メニューに移動して、**[設定エディタ]** メニューを開きます。
**[データ検出]** をクリックします。
**[デフォルトの Athena 接続を有効にする]** チェックボックスをオンにします。
必要に応じて、デフォルトの `primary` ワークグループを更新できます。

JupyterLab ノートブック内のデータベース、スキーマ、またはテーブルを SQL 拡張機能のペインの特定の接続からクエリするには:
+ データベース、スキーマ、またはテーブルの右側にある 3 つのドットアイコン (![SQL extension three dots icon.](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/sqlexplorer/sqlexplorer-3dots-icon.png)) をクリックします。
+ メニューから **[ノートブックでのクエリ]** を選択します。

  これにより、データソースに接続するために関連する `%%sm_sql` Magic コマンドが JupyterLab のノートブックセルに自動的に入力されます。直ちにクエリを開始するサポートを提供するサンプル SQL ステートメントも追加されます。拡張機能の自動完了機能と強調表示機能を使用して、SQL クエリをさらに改善できます。SQL 拡張機能の SQL エディタの使用の詳細については、「[JupyterLab SQL 拡張機能の SQL エディタ機能](sagemaker-sql-extension-features-editor.md)」を参照してください。

テーブルレベルでは、3 つのドットアイコンを使用すると、テーブルのメタデータを**プレビュー**できる追加のオプションが提供されます。

以下の JupyterLab ノートブックのセルコンテンツは、SQL 拡張機能ペインの `redshift-connection` データソースで **[ノートブックメニューでクエリ]** を選択すると自動的に生成される内容の例です。

```
%%sm_sql --metastore-id redshift-connection --metastore-type GLUE_CONNECTION

-- Query to list tables from schema 'dev.public'
SHOW TABLES
FROM
  SCHEMA "dev"."public"
```

SQL 拡張機能ペインの上部にある*次未満*記号 (![Icon to clear the SQL extension search box.](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/sqlexplorer/sqlexplorer-search-clear.png)) を使用して、検索ボックスの内容を消去するか、接続のリストに戻ります。

**注記**  
拡張機能は、高速アクセスのために探索結果をキャッシュします。キャッシュされた結果が古くなったり、接続がリストにない場合は、SQL 拡張機能パネルの下部にある **[更新]** ボタンをクリックして、キャッシュを手動で更新できます。接続キャッシュの詳細については、「[SQL 拡張機能の接続キャッシュ](sagemaker-sql-extension-features-connection-caching.md)」を参照してください。