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

# Amazon Quick Sight での Amazon OpenSearch Service の使用
<a name="connecting-to-os"></a>

以下は、Amazon Quick Sight を使用して Amazon OpenSearch Service データに接続する方法を示しています。

## OpenSearch Service の新しい Quick Sight データソース接続の作成
<a name="create-connection-to-es"></a>

ここでは、OpenSearch Service に接続する方法について説明しています。

続行する前に、Amazon Quick Sight が Amazon OpenSearch Service に接続する権限を持っている必要があります。接続が有効になっていないと、接続しようとしたときにエラーが発生します。Quick Sight 管理者は、 AWS リソースへの接続を許可できます。

**Quick Sight が OpenSearch Service への接続を開始することを許可するには**

1. 右上のプロファイルアイコンをクリックしてメニューを開き、**高速管理**を選択します。プロファイルメニューに**「高速管理**」オプションが表示されない場合は、Amazon Quick 管理者にお問い合わせください。

1. [**Security & Permissions (セキュリティとアクセス許可)**] で、[**Add or remove (追加または削除)**] を選択します。

1. [**OpenSearch**] オプションを有効にします。

1. **[更新]** を選択します。

OpenSearch Service がアクセス可能になったら、指定されたドメインをユーザーが使用可能にするため、データソースを作成します。

**OpenSearch Service に接続するには**

1. まず、新しいデータセットを作成します。左側のナビゲーションペインから**データ**を選択し、データセット**の作成**と**新規**を選択します。

1. [**Amazon OpenSearch**] データソースカードを選択します。

1. **[Data source name]** (データソース名) で、OpenSearch Service のデータソース接続のために分かりやすい名前を入力します (例: `OpenSearch Service ML Data`)。OpenSearch Service への接続からはデータセットを多数作成することがあるので、名前はシンプルにしておくことをお勧めします。

1. **[Connection type]** (接続タイプ) では、使用するネットワークを選択します。Amazon VPC ベースの仮想プライベートクラウド (VPC) またはパブリックネットワークを使用できます。VPC のリストには、VPC の ID ではなく VPC 接続の名前が記載されています。これらの名前は、クイック管理者が定義します。

1. **[Domain]** (ドメイン) で、接続先の OpenSearch Service ドメインを選択します。

1. **[Validate connection]** (接続を検証) を選択し、OpenSearch Service に正常に接続できていることを確認します。

1. **[Create data source]** (データソースを作成) を選択し、先へ進みます。

1. **[Tables]** (テーブル) で使用するテーブルを選択し、**[Select]** (選択) を選択して、先へ進みます。

1. 次のいずれかを行います。
   + Quick Sight インメモリエンジン ( と呼ばれるSPICE) にデータをインポートするには、 **にインポートSPICEを選択して分析を高速化**します。OpenSearch データのインポートを有効にする方法については、「[Amazon OpenSearch Service への接続の認証](opensearch.md)」を参照してください。
   + データセットを更新するか、分析またはダッシュボードを使用するたびに Quick Sight がデータに対してクエリを実行できるようにするには、**データの直接クエリ**を選択します。

     OpenSearch Service データを使用している公開済みのダッシュボードで自動更新を有効にするには、OpenSearch Service データセットが直接クエリを使用している必要があります。

1. **[Edit/Preview]** (編集/プレビュー) を選択し、**[Save]** (保存) を選択してデータセットを保存し、閉じます。

## OpenSearch Service データでのアクセス許可の管理
<a name="dataset-permissions-for-es"></a>

以下の手順では、同じ OpenSearch Service データソースに対するアクセス許可の表示、追加、取り消しの方法について説明します。追加するユーザーは、追加する前に Quick Sight でアクティブユーザーである必要があります。

**データソースに対するアクセス許可を編集するには**

1. 左側の**データ**を選択し、下にスクロールして Amazon OpenSearch Service 接続のデータソースカードを見つけます。例えば `US Amazon OpenSearch Service Data` などです。

1. **[Amazon OpenSearch]** データセットを選択します。

1. [Dataset details] (データセットの詳細) ページが開くので、**[Permissions]** (許可) タブを選択します。

   現在のアクセス許可の一覧が表示されます。

1. アクセス許可を追加するには、**[Add users & groups]** (ユーザーとグループの追加) を選択し、続いて以下の手順を実行します。

   1. 同じデータセットの使用を許可するユーザーまたはグループを追加します。

   1. 目的のユーザーをすべて追加したら、それらのユーザーに適用する **[Permission]** (アクセス許可) を選択します。

1. (オプション) アクセス許可を編集するには、**[Viewer]** (ビューワー) または **[Owner]** (所有者) を選択します。
   + 読み取りアクセスを許可する **[Viewer]** (ビューワー) を選択します。
   + **所有者**を選択して、そのユーザーがこの Quick Sight データセットを編集、共有、または削除できるようにします。

1. (オプション) アクセス許可を取り消すときは、**[Revoke access]** (アクセス権の取り消し) を選択します。アクセス権が取り消された人は、このデータソースから新しいデータセットを作成できなくなります。ただし、その人の既存のデータセットからは、引き続きこのデータソースにアクセスすることができます。

1. 完了したら、**閉じる** を選択します。

## OpenSearch Service の新しい Quick Sight データセットの追加
<a name="create-dataset-using-es"></a>

OpenSearch Service の既存のデータソース接続を取得した後、分析のための OpenSearch Service データセットを作成できるようになります。

**OpenSearch Service を使用してデータセットを作成するには**

1. 開始ページから、**データ**、**作成**、**新しいデータセット**を選択します。

1. 下部にある、OpenSearch Service 接続用のデータソースカードまでスクロールします。データソースが多数ある場合は、ページ上部の検索バーを使って、名前に部分一致するデータソースを検索できます。

1. [**Amazon OpenSearch**] のデータソースカードを選択し、[**データセットの作成**] をクリックします。

1. **[Tables]** (テーブル) で、使用する OpenSearch Service インデックスを選択します。

1. **[Edit/Preview]** (編集/プレビュー) を選択します。

1. **[Save]** (保存) を選択し、データセットを保存して閉じます。

## OpenSearch Service データの分析への追加
<a name="open-analysis-add-dataset-for-es"></a>

OpenSearch Service データセットが利用可能になったら、Quick Sight 分析に追加できます。これを開始する前に、使用する OpenSearch Service のデータが含まれているデータセットが、既に用意されていることを確認します。

**OpenSearch Service のデータを分析に追加するには**

1. 左側で **[Analyses]** (分析) を選択します。

1. 次のいずれかを行ってください。
   + 新しい分析を作成するときは、右側で **[New analysis]** (新しい分析) を選択します。
   + 既存の分析に追加するときは、編集する分析を開きます。
     + 左上の鉛筆アイコンを選択します。
     + **[Add data set]** (データセットを追加) を選択します。

1. 追加する OpenSearch Service データセットを選択します。

   可視化のために OpenSearch Service を使用する方法については、「[OpenSearch Service の使用に関する制限](#limitations-for-es)」を参照してください。

1. 詳細については、「[分析での作業](https://docs.aws.amazon.com/quicksight/latest/user/working-with-analyses.html)」を参照してください。

## OpenSearch Service の使用に関する制限
<a name="limitations-for-es"></a>

OpenSearch Service データセットの使用には、以下の制限が適用されます。
+ OpenSearch Service データセットでは、ビジュアルタイプ、ソートオプション、フィルターオプションのサブセットがサポートされます。
+ OpenSearch Service データを使用している公開済みのダッシュボードで自動更新を有効にするには、OpenSearch Service データセットが直接クエリを使用している必要があります。
+ マルチサブクエリ操作はサポートされていません。視覚化中のエラーを回避するには、フィールドウェルに複数のフィールドを追加せず、視覚化ごとに 1 つまたは 2 つのフィールドを使用し、**[カラー]** フィールドウェルを使用しないようにします。
+ カスタム SQL はサポートされていません。
+ クロスデータセット結合と自己結合はサポートされていません。
+ 集計フィールドはサポートされていません。
+ テキストフィールドはサポートされていません。
+ [other (その他)] カテゴリはサポートされていません。カテゴリで「その他」をサポートしている可視化機能で OpenSearch Service データセットを使用する場合は、ビジュアル上のメニューから、「その他」カテゴリの無効化を行います。