# Amazon SageMaker 接続の作成

Amazon SageMaker 接続は データ ロード エディタ または スクリプト で作成されます。

接続を作成したら、利用可能なテーブルからデータを選択して Amazon SageMaker に送信して計算し、そのデータをアプリケーションにロードできます。この接続は、データ ロード スクリプトだけでなく、モデル エンドポイントを呼び出してリアルタイムでチャート式の計算を実行するチャート式でも使用できます。

利用者は、接続したい Amazon SageMaker サービスの設定やアクセス認証情報を知っておく必要があります。

## 構成可能な設定

接続ダイアログでは、次の設定を構成できます:

接続ダイアログで設定可能な設定

| フィールド | 説明 |
| --- | --- |
| エンドポイント名 | エンドポイントの名前。<br><br>エンドポイント名は、AWS 上のエンドポイントに指定された識別子です。これは通常、エンドポイントの設定やモデルのデプロイを行うユーザーが作成します。 |
| モデル名 | デプロイしたモデルの名前。<br><br>このパラメーターは、マルチモデル エンドポイントがデプロイさている場合にのみ必要です。シンプルなエンドポイントの場合、このパラメーターは AWS からエラーをトリガーするため、指定しないでください。 |
| モデル バリアント名 | デプロイしたモデルのバリアント名。<br><br>このパラメーターは、マルチモデル エンドポイントがデプロイさている場合にのみ必要です。シンプルなエンドポイントの場合、このパラメーターは AWS からエラーをトリガーするため、指定しないでください。 |
| 設定 | 次の設定を利用できます。<br><br><ul> <li> <p><span>AWS リージョン</span>: Comprehend サービスに使用するリージョンを選択します。</p> </li> <li> <p><span>FIPS のエンドポイントを使用</span>: FIPS 準拠のエンドポイントを使用する必要がある場合に指定します。 </p> <p>これは、FIPS をサポートするリージョンを選択した場合にのみ機能します。ほとんどのユーザーは、規定値の 「No」 のままにしてください。</p> </li> </ul> |
| [Authentication] (認証) | Amazon Comprehend エンドポイントに AWS認証の Access key と Secret key を指定します。これらは、適切なポリシー権限に対するアクセス権を使用して作成する必要があります。<br><br>認証プロパティは AWS コンソールにあり、接続を再認証する必要があるたびに入力する必要があります。 |
| レスポンス フォーマット | デプロイされた機械学習モデルのレスポンス フォーマットの値:<br><br><ul> <li> <p>JSON</p> </li> <li> <p>テキストの配列</p> </li> </ul><br><br>ほとんどのモデルはデータを JSON フォーマットで返しますが、テキストベースの出力のみを返すモデルもあります。このオプションは、デプロイするモデルのタイプに基づいて選択する必要があります。選択しない場合、接続設定エラーが返されます。 |
| レスポンス テーブル | <ul> <li> <p><span>返されたテーブルの名前</span>: 展開された機械学習モデルから返されたテーブルの名前。</p> </li> <li> <p><span>テーブルのパス (JMESPath)</span>: テーブルは、JSON レスポンス配列の予測行に対する JMES テーブルのパスを使用することで指定できます。</p> </li> </ul> |
| レスポンス 項目 | <ul> <li> <p><span>利用可能な項目をすべてロード</span>: 機械学習エンドポイントによって返されたすべての使用可能な項目のロードを有効にします。これを無効にすると、アプリケーションにロードするテーブルの項目と値を指定できるようになります。</p> <p>最初に、モデルのエンドポイントから返されたすべての項目をロードしてから、アプリケーションでの分析に不要な項目を削除することをお勧めします。</p> </li> <li> <p><span>テーブル項目 (JMESPath)</span>: テーブル項目を指定するには、以下を追加します:</p> <ul> <li> <p>Name: アプリケーションにロードされるテーブルの名前です。</p> </li> <li> <p>Value: JSON レスポンス配列のレスポンス行の名前です。</p> </li> </ul> <p>JSON レスポンス配列を解析には、JMESPath クエリ言語を使用することができます。</p> </li> </ul> |
| 関連付け | <ul> <li> <p><span>関連項目</span>: 関連項目 (一意の識別子を含む入力データ テーブルの項目) を指定します。</p> <p>キーを使用してソース 項目 テーブルに関連付けるために戻された結果テーブルのエンドポイント要求を行う場合は、この項目をソース データに含める必要があります。指定された項目がレスポンスの項目として返され、予測値をデータ モデルのソース データに関連付けることができます。これは、ソース データから、またはテーブルのロード プロセスの一部として、一意の ID を持つ任意の項目です。</p> </li> <li> <p><span>関連付け項目を送信</span>: 選択すると、関連付け項目として指定された項目が <span>Qlik Sense</span> に返され、エンドポイントに送信される項目に含まれます。</p> <p>項目がソースデータに属しており、モデルで想定されている場合は、<span>[Send Association Field] (関連付け項目の送信)</span> を有効にしてモデルに送信する必要があります。</p> </li> </ul> |
| 名前 | 接続の名前。名前を入力しない場合は、既定の名前が使用されます。 |

## 新しい接続の作成

次の手順を実行します。

1. データ ロード エディターまたは スクリプト を使用してコネクタにアクセスします。

2. [接続の新規作成] をクリックします。

3. [スペース] で、接続が配置されるスペースを選択します。

4. データ コネクタのリストから Amazon SageMaker を選択します。

5. 接続ダイアログの項目に入力します。

6. [作成] をクリックします。

データ ロード エディタ または スクリプト の [データ接続] の下に接続が表示されるようになりました。