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

# ユーザー定義 AWS Glue の接続を作成する
<a name="sagemaker-sql-extension-datasources-glue-connection-user-defined"></a>

**注記**  
SQL 拡張機能 UI を介してユーザーが作成したすべての AWS Glue 接続には、次のタグが自動的に付けられます。  
`UserProfile: user-profile-name`
`AppType: "JL"`
SQL 拡張機能 UI を介して作成された AWS Glue 接続に適用されるこれらのタグは、2 つの目的を果たします。`"UserProfile": user-profile-name` タグを使用すると、 AWS Glue 接続を作成した特定のユーザープロファイルを識別し、接続を担当するユーザーを可視化できます。`"AppType": "JL"` タグは接続の出所を分類し、JupyterLab アプリケーションに関連付けます。これにより、これらの接続を AWS CLIなどの他の方法で作成された接続と区別できます。

## 前提条件
<a name="sagemaker-sql-extension-datasources-glue-connection-user-defined-prerequisites"></a>

SQL 拡張機能 UI を使用して AWS Glue 接続を作成する前に、次のタスクが完了していることを確認してください。
+ 管理者に以下を依頼します。
  + Studio ドメインと接続先のデータソース間のネットワーク通信を有効にします。ネットワークの要件については、「[Studio とデータソース間のネットワークアクセスを設定する (管理者向け)](sagemaker-sql-extension-networking.md)」を参照してください。
  + Secrets Manager への AWS Glue 接続とアクセスを管理するために必要な IAM アクセス許可が設定されていることを確認します。必要な許可については、「[データソースにアクセスするための IAM アクセス許可を設定する (管理者向け)](sagemaker-sql-extension-datasources-connection-permissions.md)」を参照してください。
**注記**  
管理者は、ユーザーアクセスを JupyterLab アプリケーション内でユーザーが作成した接続のみに制限できます。これは、ユーザープロファイルにスコープダウンされた[タグベースのアクセスコントロール](https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-sql-extension-datasources-connection-permissions.html#user-defined-connections-permissions)を設定することで実行できます。
+ [Secrets Manager でデータベース認証情報用のシークレットを作成する](sagemaker-sql-extension-glue-connection-secrets.md) でデータソースのシークレットを作成する接続プロパティと手順を確認します。

## ユーザーワークフロー
<a name="sagemaker-sql-extension-datasources-glue-connection-user-defined-steps"></a>

次の手順では、ユーザー接続を作成する際のユーザーワークフローを示します。

1. **データソースタイプを選択する**: *[新しい接続を追加]* アイコンをクリックすると、フォームが開き、Amazon Redshift、Athena、Snowflake など、接続するデータソースのタイプを選択するように求められます。

1. **接続プロパティを指定する**: 選択したデータソースに基づいて、関連する接続プロパティが動的にロードされます。フォームには、選択したデータソースに対して必須またはオプションのフィールドがあります。データソースで使用できるプロパティについては、「[接続パラメータ](sagemaker-sql-extension-connection-properties.md)」を参照してください。

1. ** AWS Secrets Manager ARN を選択する**: Amazon Redshift および Snowflake データソースの場合、ユーザーはユーザー名とパスワードなどの機密情報を保存する AWS Secrets Manager ARN を選択するように求められます。データソースのシークレット作成については、「[Secrets Manager でデータベース認証情報用のシークレットを作成する](sagemaker-sql-extension-glue-connection-secrets.md)」を参照してください。

1. **接続の詳細を保存する**: **[作成]** をクリックすると、指定された接続プロパティが AWS Glue 接続として保存されます。

1. **接続をテストする**: 接続が成功すると、関連するデータベースとテーブルがエクスプローラーに表示されます。接続に失敗した場合は、エラーメッセージが表示され、ユーザーは接続の詳細を確認して修正するよう求められます。

1. **SQL 拡張機能を理解する**: 拡張機能の機能の詳細については、「[SQL 拡張機能と使用状況](sagemaker-sql-extension-features.md)」を参照してください。

1. **(オプション) ユーザー作成の接続を更新または削除する**: ユーザーに必要なアクセス許可が付与されている場合、作成した接続を更新または削除できます。必要なアクセス許可の詳細については、「[ユーザー定義の接続にに必要な IAM アクセス許可](sagemaker-sql-extension-datasources-connection-permissions.md#user-defined-connections-permissions)」を参照してください。