翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon Quick Sight トピックの使用 | | | --- | |  適用対象: Enterprise Edition  | | | | --- | |    対象者: Amazon Quick 管理者と作成者  | *トピック*は、ビジネスユーザーが質問できるサブジェクトエリアを表す 1 つ以上のデータセットのコレクションです。 Quick Sight 自動データ準備を使用すると、エンドユーザーに関連するトピックの作成に役立つ ML を活用したサポートを受けることができます。最初のプロセスは、次のような自動フィールド選択と分類から始まります。 + 自動データ準備は、リーダーが探索する焦点を絞ったデータスペースを作成するために、デフォルトで含める少数のフィールドを選択します。 + 自動データ準備は、レポートやダッシュボードなどの他のアセットで使用するフィールドを選択します。 + 自動データ準備は、トピックが有効になっている関連する分析から追加のフィールドもインポートします。 + 日付、ディメンション、メジャーを特定して、フィールドを回答に使用する方法を学びます。 この自動フィールドセットにより、作成者は自然言語分析をすぐに開始できます。作成者は、**[Include]** (含める) トグルを使用して、必要に応じていつでもフィールドを除外したり、追加のフィールドを含めたりできます。 次に、自動データ準備は、フィールドに自動的にラベル付けし、シノニムを識別することで、プロセスを継続します。自動データ準備は、一般的な用語を使用して、フレンドリ名とシノニムでフィールド名を更新します。たとえば、`SLS_PERSON` フィールドの名前を `Sales person` に変更して、`salesman`、`saleswoman`、エージェント、`sales representative` などの同義語を割り当てることができます。自動データ準備で多くの作業を行うことができますが、フィールド、名前、シノニムを確認してエンドユーザー向けにさらにカスタマイズすることをお勧めします。たとえば、ユーザーがくだけた会話で営業担当者を「担当者」または「ディーラー」と呼ぶ場合、`SLS_PERSON` に `rep` や `dealer` を同義語に追加してこの用語をサポートします。 最後に、自動データ準備は、データをサンプリングし、分析中に作成者によって適用された形式を調べることで、各フィールドのセマンティックタイプを検出します。自動データ準備は、フィールド設定を自動的に更新し、各フィールドに使用される値の形式を設定します。したがって、質問への回答は、日付、通貨、識別子、ブール値、人物などの適切な形式で提供されます。 トピックの操作の詳細については、この章の以下のセクションに進みます。 **Topics** + [トピックの操作](navigating-topics.md) + [Quick Sight トピックの作成](topics-create.md) + [トピックワークスペース](topics-interface.md) + [Quick Sight トピックでのデータセットの操作](topics-data.md) + [Quick Sight トピックnatural-language-friendlyにする](topics-natural-language.md) + [Quick Sight トピックの共有](topics-sharing.md) + [Amazon Quick Sight トピックのアクセス許可の管理](topics-sharing-permissions.md) + [Quick Sight トピックのパフォーマンスとフィードバックの確認](topics-performance.md) + [Quick Sight トピックインデックスの更新](topics-index.md) + [Amazon Quick Sight APIs](topics-cli.md) # トピックの操作 Quick Sight では、トピックを作成および管理する方法が複数あります。Amazon Quick のホームページまたは「開始」ページで開始できます。または、分析の内部から開始することもできます。 **Topics** + [Amazon Quick ホームページから](starting-from-home.md) + [Amazon Quick Sight 分析から](starting-from-sheets.md) + [Amazon Quick Sight 分析での質問のナビゲーション](starting-from-questions-on-sheets.md) # Amazon Quick ホームページから クイックスタートページから、左側のナビゲーションペインで**トピック**を選択してトピックを作成および管理できます。Quick は、トピックを作成するためのガイド付きワークフローを提供します。作業を中断させることなく、ガイド付きワークフローからステップアウトし、後で戻ることができます。 トピックを作成すると、ビジネスユーザーはトピックについて質問できます。トピックをいつでも開いて変更したり、そのパフォーマンスを確認したりできます。 トピックを開くには、トピック名をクリックします。 いつでもすべてのトピックのリストに戻りたい場合は、トピックワークスペースの左側の [**All topics**] を選択します。 # Amazon Quick Sight 分析から Amazon Quick Sight 分析から開始するには、自動データ準備 で使用する分析を開きます。 トピックを開くか作成するには、上部のナビゲーションバーのトピックアイコンを選択します。 トピックをいつでも開いて変更したり、そのパフォーマンスを確認したりできます。 分析からトピックを開くには、上部のナビゲーションバーでトピック名を選択します (まだ表示されていない場合)。次に、上部のナビゲーションバーにある縦の省略記号アイコン (` ⋮ `) を選択します。 トピックに関する情報を表示するには、**[About topic]** (トピックについて) を選択します。 トピックに含まれるデータフィールドを表示するには、タブリストで **[Data fields]** (データフィールド) を選択します。 # Amazon Quick Sight 分析での質問のナビゲーション 分析でトピックに関する質問と回答を確認することで、そのトピックがどのように使用されているかを知ることができます。この情報は、必要に応じて調整を行うため情報となります。 すでにトピックにリンクされている分析内から、上部のナビゲーションバーの検索バーを選択し、質問を入力します。回答はトピック画面に表示され、分析でトピックを操作するために使用可能なすべてのオプションも表示されます。 + 回答に表示されるビジュアルのタイプを変更するには、タイプアイコン (棒グラフに似ています) を選択します。 + 改善案を表示するには、音声吹き出しを選択します。未確認の提案がある場合は強調表示されます。 + 質問に関連するインサイトを表示するには、電球アイコンを選択します。 + ピンボードに質問を追加または削除するには、**[Add to pinboard]** (ピンボードに追加) または **[Remove from pinboard]** (ピンボードから削除) のアイコンを切り替えます。上部のナビゲーションバーからピンボードアイコンを選択すると、ピンボードを表示できます。 + このトピックに関する情報を表示するには、丸で囲まれた小文字の *i* (` ![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/status-info.png) `) を選択してください。 + 省略記号メニュー (` … `) を選択して、次のいずれかのアクションを実行します。 + **CSV にエクスポート** – 選択したビジュアルに表示されているデータをエクスポートします。 + **リクエスト ID のコピー** – トラブルシューティングのためにこのプロセスのリクエスト ID をキャプチャします。Amazon Quick Sight は、各プロセスを一意に識別するための英数字のリクエスト ID を生成します。 + **[Share this visual]** (このビジュアルを共有) — ビジュアルで使用されているトピックの URL を安全に共有します。 + **回答の内訳** – 回答の詳細な説明が表示されます。 トピック画面の下部にある **[Edit question variants]** (質問のバリエーションを編集) を選択して、質問のバリエーションを追加または変更できます。また、下部にある質問と回答に満足したら、**[Mark as reviewed]** (レビュー済みにする) を選択してトピックをレビュー済みとしてマークします。あるいは、以前にレビューしたトピックをさらに確認する必要がある場合は、**[Unmark as reviewed]** (レビュー済みのマークを解除する) を選択します。 トピックをいつでも開いて変更したり、そのパフォーマンスを確認したりできます。どのフィールドが含まれるか、どの同義語があるかなど、トピックの設定を直接操作するには、**[Topics]** (トピック) ページを使用してください。 **分析にリンクされたトピックを開くには** 1. 左側のナビゲーションペインで**トピック**を選択して、クイックスタートページから Amazon Quick Sight **トピック**ページを開きます。 分析を開いたままにしておきたい場合は、新しいブラウザタブまたはウィンドウで **[Topics]** (トピック) ページを開くことができます。 1. トピックを開くには、トピック名をクリックします。最近分析ページから移動した場合は、おそらく画面上部の検索バーに名前が表示されます。 1. いつでもすべてのトピックのリストに戻りたい場合は、トピックワークスペースの左側の [**All topics**] を選択します。 # Quick Sight トピックの作成 | | | --- | |  適用対象: Enterprise Edition  | | | | --- | |    対象者: Amazon Quick 管理者と作成者  | データセットの質問を有効にするには、トピックを作成する必要があります。Quick Sight は、トピックを作成するためのガイド付きワークフローを提供します。作業を中断させることなく、ガイド付きワークフローからステップアウトし、後で戻ることができます。 トピックを作成する方法は 2 つあります。 + データセットを選択してトピックを作成します。Quick Sight でトピックを作成するときに、複数のデータセットを追加したり、分析でトピックを有効にしたりできます。 + 分析を使用してトピックを作成します。分析でトピックを作成するか、既存のトピックを分析にリンクすると、自動データ準備は、データの分析方法から学習し、トピックに自動的に適用します。 クイックリーダーとトピックを共有し、それを使用して検索バーで質問すると、トピックのパフォーマンスの概要を確認できます。また、ユーザーが求めたすべての内容とその応答状況、検証した回答のリストを表示することもできます。フィードバックを確認することは、ビジネスユーザーに正しい視覚化と質問に対する回答を提供し続けるために重要です。 ## トピックの作成 以下の手順に従ってトピックを作成します。 **トピックを作成する** 1. クイックホームページで、**トピック**を選択します。 1. 開いた**トピック**ページで、右上の**トピックの作成**を選択します。 1. トピック**の作成**ページで、次の操作を行います。 1. [**Topic name**] に、トピックの名前を入力します。 ビジネスユーザーはこの名前でトピックを識別し、それを使用して質問します。 1. [**説明**] に、トピックの説明を入力します。 ユーザーはこの説明を使用して、トピックの詳細情報を得ます。 1. [**続行**] をクリックしてください。 1. 開いた [**Add data to topic**] ページで、次のいずれかのオプションを選択します。 + 所有している、または権限を持つデータセットを 1 つ以上追加するには、[**Dataset**] を選択した後、追加する 1 つまたは複数のデータセットを選択します。 + 作成したダッシュボードまたは共有されたダッシュボードからデータセットを追加するには、**ダッシュボードからデータセット**を選択し、リストからダッシュボードを選択します。 1. [**データの追加**] を選択します。 トピックが作成され、そのトピックのページが開きます。次のステップは、リーダーに自然な言語に対応するようにトピックメタデータを構成することです。詳細については、「[Quick Sight トピックnatural-language-friendlyにする](topics-natural-language.md)」を参照してください。または、次のトピックに進み、トピックワークスペースを試します。 # トピックワークスペース | | | --- | |  適用対象: Enterprise Edition  | | | | --- | |    対象者: Amazon Quick 管理者と作成者  | トピックを作成した後、または [**トピック**] ページのリストから既存のトピックを選択すると、そのトピックのワークスペースにトピックが開きます。ここでは、次のセクションで説明するように 4 つのタブを使用できます。Quick Sight は、トピックのガイド付きワークフローを提供します。作業を中断させることなく、ガイド付きワークフローからステップアウトし、後で戻ることができます。 ## 概要 [**概要**] タブには、次の 3 つの重要なエリアがあります。 + **提案** - 提案は、トピックを改善する方法についての詳しいガイダンスを提供します。これらのステップは、よりパフォーマンスの高いトピックを作成する方法を理解するのに役立ちます。 提案をフォローするには、[提案] バナーの [アクション] ボタンを選択し、推奨されるステップに従います。 現在、次の表に示す順序で提供される 8 つのプリセット候補があります。提案のステップを完了した後、[**概要**] タブに戻ると、新しい提案が提供されています。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/topics-interface.html) + **トピックのエンゲージメントとパフォーマンスに関するメトリクスと重要業績評価指標 (KPI)** - このセクションでは、リーダーのトピックへのエンゲージメント、提供された回答に対するフィードバックと評価を確認できます。ユーザーが尋ねたすべての質問のエンゲージメントを表示したり、特定の質問を選択できます。メトリクスの期間を 1 年から 1 週間に変更することもできます。 詳細については、「[Quick Sight トピックのパフォーマンスとフィードバックの確認](topics-performance.md)」を参照してください。 + **データセット** - このセクションには、トピックの作成に使用されたデータセットが表示されます。このセクションでは、データセットを追加したり、既存のダッシュボードからデータセットをインポートしたりできます。また、トピックデータセットのメタデータの編集、データ更新スケジュールの設定、データセット名の変更などを行うことができます。詳細については、「[Quick Sight トピックでのデータセットの操作](topics-data.md)」を参照してください。 ## データ [**データ**] タブには、トピックに含まれるすべてのフィールドが表示されます。ここでは、トピックのメタデータを構成して、トピックを自然言語に対応させ、トピックのパフォーマンスを向上させます。詳細については、「[Quick Sight トピックnatural-language-friendlyにする](topics-natural-language.md)」を参照してください。 ## ユーザーアクティビティ このタブには、トピックが受け取るすべての質問と、各質問の全体的なフィードバックが表示されます。質問された質問の数と、そのうち肯定的、否定的質問の割合の概要を確認できます。フィードバックや、フィードバックとともにコメントを残したかどうかでフィルタリングできます。詳細については、「[Quick Sight トピックのパフォーマンスとフィードバックの確認](topics-performance.md)」を参照してください。 ## 検証済みの回答 *検証済みの回答*は、ビジュアルが事前に設定されている質問です。質問に対する検証済みの回答を作成するには、検索バーで質問をし、レビュー済みとしてマークします。[**Verified Answers**] タブを使用して、確認済みの回答と、ユーザーが受け取ったフィードバックを確認できます。 # Quick Sight トピックでのデータセットの操作 | | | --- | |  適用対象: Enterprise Edition  | | | | --- | |    対象者: Amazon Quick 管理者と作成者  | トピックを作成するときに、そのトピックにデータセットを追加したり、既存のダッシュボードからデータセットをインポートしたりできます。データセットのメタデータを編集し、データ更新スケジュールをいつでも設定できます。また、計算フィールド、フィルター、または名前付きエンティティを作成して、トピック内のデータセットに新しいフィールドを追加することもできます。 **Topics** + [Amazon Quick Sight のトピックへのデータセットの追加](topics-data-add.md) + [Amazon Quick Sight トピックへの行レベルセキュリティ (RLS) を使用したデータセットの追加](topics-data-rls.md) + [Quick Sight トピックのデータセットの更新](topics-data-refresh.md) + [Amazon Quick Sight トピックからのデータセットの削除](topics-data-remove.md) + [Amazon Quick Sight トピックデータセットへの計算フィールドの追加](topics-data-calculated-fields.md) + [Amazon Quick Sight トピックデータセットへのフィルターの追加](topics-data-filters.md) + [Amazon Quick Sight トピックデータセットに名前付きエンティティを追加する](topics-data-entities.md) # Amazon Quick Sight のトピックへのデータセットの追加 データセットはいつでもトピックに追加できます。次にその手順を説明します。 **トピックにデータセットを追加するには** 1. 1 つまたは複数のデータセットを追加するトピックを開きます。 1. **概要**ページで、**データ**を選択します。次に、**データセット** でデータセット**の追加** を選択します。 1. 開いたの [**Add datasets**] ページで、追加するデータセットを選択し、その後 [**Add datasets**] を選択します。 データセットがトピックに追加され、データセットの一意の文字列値がインデックス化されます。フィールド設定は、すぐに編集できます。詳細については、「[Quick Sight トピックインデックスの更新](topics-index.md)」を参照してください。フィールド設定の編集の詳細については、「」を参照してください[Quick Sight トピックnatural-language-friendlyにする](topics-natural-language.md)。 # Amazon Quick Sight トピックへの行レベルセキュリティ (RLS) を使用したデータセットの追加 行レベルのセキュリティ (RLS) を含むデータセットをトピックに追加できます。トピック内のすべてのフィールドは、データセットに適用された RLS ルールに従います。たとえば、ユーザーが「リージョン別の売上を表示」と尋ねた場合、返されるデータは、基になるデータへのユーザーのアクセスに基づいています。したがって、東リージョンのみを表示できる場合、東リージョンのデータのみが回答に表示されます。 RLS ルールは、ユーザーが質問しているときの自動提案に適用されます。ユーザーが質問を入力すると、ユーザーがアクセスできる値のみが提案されます。アクセスできないディメンション値に関する質問をユーザーが入力しても、その値に関する回答は得られません。例えば、上記と同じユーザーが「show me sales in the West region」(西地域内の売上高を表示する) という質問を入力しているとします。この場合、そのような質問をしたとしても、ユーザーに提案や回答は提供されません。その地域に対する RLS アクセス権がないからです。 デフォルトでは、Quick Sight により、ユーザーは RLS でのユーザーのアクセス許可に基づいてフィールドについて質問できます。アクセスを制限したい機密データがフィールドに含まれている場合は、引き続きこのオプションを使用してください。フィールドに機密情報が含まれておらず、すべてのユーザーに提案の情報を表示させたい場合は、フィールド内のすべての値に対して質問を許可するように選択できます。 **すべてのフィールドに関する質問を許可する** 1. クイックホームページから、**データ**を選択します。 1. **データセット**タブで、RLS を追加したデータセットを選択し、**データセットの編集**を選択します。 データセットへの RLS の追加に関する詳細については、[Amazon Quick での行レベルのセキュリティの使用](row-level-security.md) を参照してください。 1. データ準備ページで、 を許可するフィールドのフィールドメニュー (3 つのドット) を選択し、**行レベルのセキュリティ **を選択します。 1. 開く**クイックページの行レベルのセキュリティ**で、**このフィールドのすべての値についてユーザーに質問を許可する**を選択します。 1. **[Apply]** (適用) を選択します。 1. データセットの編集が終了したら、右上の青いツールバーにある **[Save & publish]** (保存して公開) をクリックします。 1. データセットをトピックに追加します。詳細については、前述のセクション、[Amazon Quick Sight のトピックへのデータセットの追加](topics-data-add.md) を参照してください。 現在すべての値について質問することをユーザーに許可しているが、機密情報を保護するためにデータセットの RLS ルールを実装したいという場合は、ステップ 1～4 を繰り返して、**[Allow users to ask questions regarding this field based on their permissions]** (ユーザーのアクセス許可に基づいて、ユーザーがこのフィールドについて質問することを許可する) を選択します。完了したら、トピック内のデータセットを更新します。詳細については、「[Quick Sight トピックのデータセットの更新](topics-data-refresh.md)」を参照してください。 # Quick Sight トピックのデータセットの更新 トピックにデータセットを追加するときに、そのデータセットを更新する頻度を指定できます。トピック内のデータセットを更新すると、そのトピックのインデックスが新規および更新された情報で更新されます。 データセットをトピックに追加しても、データセットはレプリケートされません。一意の文字列値のインデックスが作成され、メトリクスはインデックス化されません。たとえば、整数として保存されたメジャーはインデックス化されません。質問は、データセット内のデータに基づいて常に最新の売上メトリクスを取得します。 トピックインデックスの更新の詳細については、「[Quick Sight トピックインデックスの更新](topics-index.md)」を参照してください。 トピック内のデータセットの更新スケジュールを設定することも、データセットを手動で更新することもできます。また、データが最後に更新された日時も確認できます。 **トピックデータセットの更新スケジュールを設定するには** 1. 変更するトピックを開きます。 1. **概要**ページで、**データ**を選択します。次に、**データセット**で、更新スケジュールを設定するデータセットを展開します。 1. [**Add schedule**] を選択し、開いた [**Add refresh schedule**] ページで以下のいずれかの操作を行います。 + データセットが SPICE データセットである場合は、**[Refresh topic when dataset is imported into SPICE]** (データセットが SPICE にインポートされたときにトピックを更新する) を選択します。 現在、時間単位の更新SPICEデータセットはサポートされていません。1 時間ごとに更新するように設定されたSPICEデータセットは、自動的に日次更新に変換されます。SPICE データセットの更新スケジュールの設定に関する詳細については、[SPICE データの更新](refreshing-imported-data.md) を参照してください。 + データセットがダイレクトクエリデータセットである場合は、次の操作を行います。 1. [**タイムゾーン**] でタイムゾーンを選択します。 1. [**Repeats**] で、更新を実行する頻度を選択します。データセットは、毎日、毎週、または毎月更新するかを選択できます。 1. [**Refresh time**] で、更新を開始する時刻を入力します。 1. [**Start first refresh on**] で、データセットの更新を開始する日付を選択します。 1. **[保存]** を選択します。 **データセットを手動で更新するには** 1. トピック**「概要**」ページで、**「データ**」を選択します。次に、**データセット** で、更新するデータセットを選択します。 1. [**Refresh now**] を選択します。 **データセットの更新履歴を表示するには** 1. トピックの**「概要**」ページで、**「データ**」を選択します。次に、**データセット**で、更新履歴を表示するデータセットを選択します。 1. [**View history (履歴の表示)**] を選択します。 [**Update history**] ページが開き、データセットが更新された時刻のリストが表示されます。 # Amazon Quick Sight トピックからのデータセットの削除 トピックからデータセットを削除できます。トピックからデータセットを削除しても、Quick Sight からは削除されません。 トピックからデータセットを削除するには、以下の手順を使用します。 **トピックからデータセットを削除するには** 1. 変更するトピックを開きます。 1. **概要**ページで、**データ**を選択します。次に、**データセット**で、右側のデータセットメニュー (3 つのドット) を選択し、**トピックから削除**を選択します。 1. 開いた [**Are you sure you want to delete?**] ページで、[**Delete**] をクリックして、トピックからデータセットを削除します。トピックからデータセットを削除しない場合、[**Cancel**] を選択します。 # Amazon Quick Sight トピックデータセットへの計算フィールドの追加 計算フィールドを作成することで、トピックに新しいフィールドを作成できます。[*Calculated fields*] は、新しいデータを作成するために、サポートされている関数を持つデータセットから 1 つまたは 2 つのフィールドを組み合わせて使用するフィールドです。 例えば、データセットに売上と経費の列が含まれている場合、計算フィールドと単純な関数を組み合わせて、利益列を作成できます。この関数は次のようになります。`sum({Sales}) - sum({Expenses})`。 **トピックに計算フィールドを追加するには** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Actions**] で、[**Add calculated field**] を選択します。 1. 開いた計算エディタで、以下の作業を行います。 1. 計算フィールドにわかりやすい名前を付けます。 1. 右側の [**Datasets**] で、計算フィールドに使用するデータセットを選択します。 1. 左側の計算エディタに計算を入力します。 データセット内のフィールドのリストは、右側の [**Fields**] ペインで確認できます。サポートされている関数のリストについては、右側の [**Functions**] ペインで確認できます。 Quick Sight で計算を作成するために使用できる関数と演算子の詳細については、「」を参照してください[Amazon Quick の計算フィールド関数と演算子リファレンス関数と演算子](calculated-field-reference.md)。 1. 完了したら、**[保存]** を選択します。 計算フィールドがトピックのフィールドのリストに追加されます。説明を追加し、メタデータを構成して、より自然言語に対応するようにできます。 # Amazon Quick Sight トピックデータセットへのフィルターの追加 ビジネスユーザー (リーダー) が、データ内の複数の値のセルにマッピングする用語を含む質問をすることがあります。たとえば、読者の 1 人が「Show me weekly sales trend in the west」と言ったとします。この例では「*西部*」は、`Region` フィールド内の `Northwest` および `Southwest` の両方の値を指し、回答を生成するためにデータをフィルタリングする必要があります。トピックにフィルターを追加して、このようなリクエストをサポートすることができます。 **トピックにフィルターを追加するには** 1. フィルターを追加するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**アクション**] で [**Add filter**] を選択します。 1. 開いた [**Filter configuration**] ページで、次の操作を行います。 1. [**Name**] で、フィルターのわかりやすい名前を入力します。 1. [**Dataset**] で、フィルターを適用するデータセットを選択します。 1. [**Field**] で、フィルタリングするフィールドを選択します。 選択したフィールドのタイプに応じて、異なるフィルタリングオプションが提供されます。 + テキストフィールドを選択した場合 (例えば、`Region`) は、次の操作を行います。 1. [**Filter type**] で、必要なフィルターのタイプを選択します。 フィルターのテキストフィールドの詳細については、「[テキストフィルターの追加](add-a-text-filter-data-prep.md)」を参照してください。 1. [**Rule**] で、ルールを選択します。 1. [**Value**] で、1 つまたは複数の値を入力します。 + 日付フィールドを選択した場合 (例えば、`Date`) は、次の操作を行います。 1. [**Filter type**] で、使用するフィルターのタイプを選択し、フィルターを適用する日付を入力します。 日付のフィルタリングについての詳細は、「[日付フィルターの追加](add-a-date-filter2.md)」を参照してください。 + 数字フィールドを選択した場合 (例えば、`Compensation`) は、次の操作を行います。 1. [**Aggregation**] で、フィルタリングされた値を集計する方法を選択します。 1. [**Rule**] で、フィルターのルールを選択し、そのルールの値を入力します。 数字フィールドのフィルタリングの詳細については、「[数値フィルターの追加](add-a-numeric-filter-data-prep.md)」を参照してください。 1. (オプション) フィルターが適用されるタイミングを指定するには、[**Apply the filter anytime the dataset is used**] を選択し、以下のいずれかのオプションを選択します。 + [**常に適用する**] - このオプションを選択すると、指定したデータセットの列が質問にリンクされるたびにフィルターが適用されます。 + [**質問がデータセットからの明示的なフィルターの結果とならない場合は、常に適用する**] - このオプションを選択すると、指定したデータセットの列が質問にリンクされるたびにフィルターが適用されます。ただし、質問が同じフィールドの明示的なフィルターに言及されている場合、フィルターは適用されません。 1. 完了したら、**[保存]** を選択します。 フィルターがトピックのフィルターのリストに追加されます。その説明を編集したり、フィルターが適用されるタイミングを調整したりできます。 # Amazon Quick Sight トピックデータセットに名前付きエンティティを追加する トピックについて質問するとき、リーダーは各列を明示的に記述せずに複数のデータ列を参照することがあります。例えば、取引の住所を要求する場合があります。その実際の意味は、取引が行われたの支店名、州、および都市がほしいということです。このようなリクエストをサポートするには、名前付きエンティティを作成します。 *名前付きエンティティ*は、回答にまとめて表示されるフィールドを集めたものです。例えば、取引住所の例を使用して、「`Address`」と呼ばれる名前付きエンティティを作成できます。次に、データセット内にすでに存在しているエンティティに、`Branch Name`、`State`、および `City` 列を追加します。誰かが住所について質問すると、その回答には、取引が行われた支店、州、および都市が表示されます。 **トピックに名前付きエンティティを追加するには** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Actions**] で、[**Add named entity**] を選択します。 1. 開いた [**Named entity**] ページで、次の操作を行います。 1. [**Dataset**] で、データセットを選択します。 1. [**Name**] で、名前付きエンティティのわかりやすい名前を入力します。 1. [**Description**] で、名前付きエンティティの説明を入力します。 1. (オプション)[**Synonyms**] で、リーダーが名前付きエンティティまたはそれに含まれるデータを参照するために使用する可能性のある別名を追加します。 1. [**Add field**] を選択し、その後リストからフィールドを選択します。 [**Add field**] をもう一度選択し、別のフィールドを追加します。 ここに一覧表示されているフィールドの順序は、回答に表示される順序です。フィールドを移動するには、フィールド名の左にある 6 つのドットを選択し、目的の順序にフィールドをドラッグアンドドロップします。 1. 完了したら、**[保存]** を選択します。 名前付きのエンティティがトピックのフィルターのリストに追加されます。説明を追加し、メタデータを追加して、より自然言語に対応するようにできます。 # Quick Sight トピックnatural-language-friendlyにする | | | --- | |  適用対象: Enterprise Edition  | | | | --- | |    対象者: Amazon Quick 管理者と作成者  | トピックを作成すると、Quick Sight はそのトピック内のデータの定義を含むインデックスを作成、保存、維持します。このインデックスは、正しい回答を生成し、誰かが質問したときにオートコンプリート提案を行い、用語の列またはデータ値へのマッピングを提案するために使用されます。これは、リーダーの質問で主要な用語を解釈し、データにマッピングする方法です。 データを解釈し、読者の質問により的確に回答できるように、データセットとそれに関連するフィールドに関する情報をできるだけ多く提供してください。 そのためには、次の手順を使用して、トピックをより自然言語に対応しやすくします。 **ヒント** 一括アクションを使用して、一度に複数のフィールドを編集できます。トピック内のフィールドを一括編集するには、以下の手順を使用します。 **トピック内のフィールドを一括編集するには** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Fields**] で、変更するフィールドを 2 つ以上選択します。 1. リストの上部にある [**Bulk Actions**] を選択します。 1. 飛開いた [**Bulk Actions**] ページで、必要なフィールドを構成し、その後 [**Apply to**] を選択します。 設定オプションは、次のステップで説明します。 ## ステップ 1: データセットにわかりやすい名前と説明を付ける データセット名は、リーダーがそれを示すために普通使用しない技術的な命名規則に基づいていることがよくあります。データセットに含まれるデータに関するさらに情報を提供するために、データセットにわかりやすい名前と説明を付けることをお勧めします。これらのわかりやすい名前と説明は、データセットの内容を理解し、読者の質問に基づいてデータセットを選択するために使用されます。データセット名は、回答の追加コンテキストを提供するためにリーダーにも表示されます。 例えば、データセットに `D_CUST_DLY_ORD_DTL` という名前が付けられている場合は、トピック内の名前を `Customer Daily Order Details` に付け直します。これにより、読者がトピックの検索バーにリストされているのを見ると、データが自分に関連しているかどうかをすぐに判断できます。 **データセットにわかりやすい名前と説明を付けるには** 1. 変更するトピックを開きます。 1. **概要**タブで、**データ**を選択します。次に、**データセット**で、データセットの右端にある下矢印を選択して展開します。 1. 左側のデータセット名の横にある鉛筆アイコンをクリックし、わかりやすい名前を入力します。リーダーが理解できる名前を使用することをお勧めします。 1. [**Description**] で、データセットに含まれるデータを説明するデータセットの説明を入力します。 ## ステップ 2: データセットで日付フィールドを使用する方法を指示する データセットに日付と時刻の情報が含まれている場合は、質問に回答するときにその情報を使用する方法を指示することをお勧めします。これは、トピックに複数の日付時刻列がある場合に特に重要です。 場合によっては、注文日や出荷日など、トピックに複数の有効な日付列があります。このような場合は、質問への回答に使用するデフォルトの日付を指定することで、閲覧者を支援できます。デフォルトの日付が質問に答えになっていない場合、リーダーは別の日付を選択できます。 また、時間ベースを指定して、日付と時刻の列の粒度を指定することもできます。データセットの*時間基準*は、データセット内のすべての数値でサポートされている、最も詳細でないレベルの時間です。この設定は、異なる時間ディメンションにわたってデータセット内のメトリクスを集約するのに役立ちます。また、単一の日付時刻の詳細度をサポートするデータセットに適用されます。このオプションは、多数のメトリクスを持つ非正規化データセットに対して設定できます。例えば、データセットが日次集計で複数のメトリクスをサポートしている場合、そのデータセットの時間基準を [**Daily**] に設定できます。次に、これを使用してメトリクスを集約する方法を決定します。 **データセットのデフォルトの日付と時刻の基準を設定するには** 1. 変更するトピックを開きます。 1. **概要**タブで、**データ**を選択します。次に、**データセット**で、データセットの右端にある下矢印を選択して展開します。 1. [**Default date**] で、日付フィールドを選択します。 1. **時間ベース**では、データセット内のメトリクスを集約する最も低いレベルの粒度を選択します。トピックのメトリクスは、毎日、毎週、毎月、四半期ごと、または毎年集計できます。 ## ステップ 3: 使用されていないフィールドを除外する データセットをトピックに追加すると、データセット内のすべての列 (フィールド) がデフォルトで追加されます。データセットに自分やリーダーが使用しないフィールドが含まれている場合、または回答に含めたくないフィールドがある場合は、トピックから除外できます。これらのフィールドを除外すると、回答とインデックスから削除され、読者が受け取る回答の精度が向上します。 **トピック内のフィールドを除外するには** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Fields**] セクションの [**Include**] で、アイコンをオフに切り替えます。 ## ステップ 4: フィールドの名前を自然言語対応の名前に変更する データセット内のフィールドは、多くの場合、技術的な命名規則に基づいて名前が付けられます。トピックの名前を変更して説明を追加することで、トピック内のフィールド名をよりわかりやすくすることができます。 フィールド名は、フィールドを理解し、読者の質問の用語にリンクするために使用されます。フィールド名がユーザーフレンドリであれば、データとリーダーの質問の間にリンクを簡単に描画できます。これらのわかりやすい名前は、追加のコンテキストを提供するために、質問に対する回答の一部としてリーダーに提示されます。 **名前を変更してフィールドに説明を追加するには** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Fields**] セクションで、フィールドの右端にある下向き矢印をクリックして展開します。 1. 左側のフィールド名の横にある鉛筆アイコンをクリックし、わかりやすい名前を入力します。 1. [**説明**] に、フィールドの説明を入力します。 ## ステップ 5: フィールドとフィールド値にシノニムを追加する フィールド名をユーザーにわかりやすいものに更新して説明を入力しても、リーダーは別の名前でそれらを呼ぶことができます。例えば、`Sales` フィールドは、読者の質問で `revenue`、`rev`、または `spending` と呼ばれることがあります。 これらの用語を理解し、正しいフィールドにマッピングするために、フィールドに 1 つ以上のシノニムを追加できます。これにより、精度が向上します。 フィールド名と同様に、リーダーはフィールド内の特定の値を示すために異なる名前を使用する場合があります。例えば、`NW`、`SE`、`NE`、および `SW` の値を含むフィールドがある場合、それらの値にシノニムを追加できます。`NW` に`Northwest` 、`SE` に `Southeast` などを追加できます。 **フィールドにシノニムを追加するには** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Fields**] セクションの [**Synonyms**] で、フィールドの鉛筆アイコンをクリックし、単語または語句を入力し、キーボードの [Enter] キーを押します。別のシノニムを追加するには、[**\$1**] アイコンをクリックします。 **フィールドの値のシノニムを追加するには** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Fields**] セクションで、右端にある下向き矢印をクリックしてフィールドの情報を展開します。 1. 右側の [**Value Preview**] で、[**Configure value synonyms**] を選択します。 1. 開いた [**Field Value Synonyms**] ページで、[**Add**] を選択し、その後以下の操作を行います。 1. [**Value**] で、シノニムを追加する値を選択します。 1. [**Synonyms**] で、値のシノニムを 1 つ以上入力します。 1. **[保存]** を選択します。 1. 別の値にシノニムを追加するには、ステップ 5～6 を繰り返します。 1. 完了したら、[**Done**] を選択します。 ## ステップ 6: フィールドの詳細を説明する データを使用して読者の質問に答える方法を解釈しやすくするために、データセット内のフィールドについて詳しく説明できます。 データセット内のフィールドがディメンションであるかメジャーであるかを判断でき、そのフィールドを集約する方法を指定できます。また、フィールド内の値の書式設定方法や、フィールド内のデータタイプを明確にすることもできます。これらの追加設定を構成すると、読者が質問したときに正確な回答を作成できます。 フィールドの詳細については、以下の手順に従います。 ### フィールドロールを割り当てる データセット内のすべてのフィールドは、ディメンションまたはメジャーのいずれかです。[*Dimensions*] は、カテゴリのデータで、[*measures*] は定量的なデータです。フィールドがディメンションかメジャーかを知ることで、フィールドに対して実行できるオペレーションと実行できないオペレーションが決まります。 たとえば、フィールド `Patient ID`、、 を設定すると`Employee ID`、それらのフィールドを整数として解釈する`Ratings`のに役立ちます。この設定は、測定時にフィールドが集計されないことを意味します。 **フィールドロールを設定するには** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Fields**] セクションで、右端にある下向き矢印をクリックしてフィールドの情報を展開します。 1. [**Role**] で、ロールを選択します。 メジャーまたはディメンションを選択できます。 1. (オプション) メジャーが反比例する場合 (例えば、数値が小さいほど良い)、**[Inverted measure]** (半比例メジャー) を選択します。 ここでは、このフィールドの値を解釈して表示する方法について説明します。 ### フィールド集計を設定する フィールド集約を設定すると、それらのフィールドが複数の行に集約されるときにどの関数を使用するかしないかを判断するのに役立ちます。フィールドのデフォルトの集計と、許可されていない集計を設定できます。 [*デフォルトの集計*] は、リーダーの質問で明示的な集計関数が言及または特定されていない場合に適用される集計です。たとえば、読者の 1 人が「昨日販売された製品の数」と尋ねたとします。この場合、Q はフィールド `Product ID` を使用します。これは `count distinct` デフォルトの集計を持ち、質問に答えます。これを行うと、製品 ID の目立つ数を示すビジュアルが表示されます。 [*許可されていない集計*] は、質問への回答するフィールドで使用されない集計です。質問で、許可されていない集計が明確に求められた場合でも、これらは除外されます。例えば、`sum` が `Product ID` フィールドを決して集計してはならないと指定するとします。読者の 1 人が「昨日販売された製品の合計数」と尋ねた場合でも、 `sum`は質問への回答には使用されません。 集計関数がフィールドに対して正しく適用されていない場合は、フィールドに対して許可されていない集計を設定することをお勧めします。 **フィールド集計を設定するには** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Fields**] セクションで、右端にある下向き矢印をクリックしてフィールドの情報を展開します。 1. **デフォルトの集計**では、デフォルトでフィールドを集計する集計を選択します。 メジャーは、合計、平均、最大、および最小を集計できます。 ディメンションは、カウント、個別のカウント集計できます。 1. (オプション) **許可されていない集計**では、使用しない集計を選択します。 1. (オプション) フィルターでフィールドを集計しない場合は、**フィルターで集計しない**を選択します。 ### フィールド値のフォーマット方法を指定する フィールドの値のフォーマット方法を説明する場合は、それを行うことができます。例えば、フィールド `Order Sales Amount` を持っているとします。これには、米ドルとしてフォーマットする値が含まれます。この場合、回答で使用する場合、 フィールドの値を米国通貨としてフォーマットする方法を説明できます。 **フィールド値のフォーマット方法を指定する** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Fields**] セクションで、右端にある下向き矢印をクリックしてフィールドの情報を展開します。 1. [**Value format**] で、フィールドの値の書式設定を選択します。 ### フィールドのセマンティックタイプを指定する フィールド [*semantic type*] は、フィールド内のデータによって表される情報のタイプです。例えば、位置データ、通貨データ、年齢データ、ブール値データを含むフィールドがあるとします。フィールドにセマンティックタイプと追加のセマンティックサブタイプを指定できます。これらを指定すると、フィールドに保存されているデータの意味を理解するのに役立ちます。 以下の手順に従って、フィールドセマンティックタイプとサブタイプを指定します。 **フィールドセマンティックタイプを指定するには** 1. 変更するトピックを開きます。 1. トピックで、[**Data**] タブを選択します。 1. [**Fields**] セクションで、右端にある下向き矢印をクリックしてフィールドの情報を展開します。 1. [**Semantic type**] で、データが表す情報の種類を選択します。 メジャーは、期間、日付部分、場所、ブール値、通貨、パーセンテージ、年齢、距離、および識別子タイプを選択できます。ディメンションは、日付パート、場所、ブール、個人、組織、および識別子のタイプを選択できます。 1. [**Semantic sub-type**] で、データが表す情報の種類をさらに指定するオプションを選択します。 ここでのオプションは、選択したセマンティックタイプとフィールドに関連付けられたロールによって異なります。メジャーとディメンションのセマンティックタイプとそれに関連するサブタイプのリストについては、次の表を参照してください。 | セマンティックタイプ | セマンティックサブタイプ | 以下で使用できます。 | | --- | --- | --- | | 年齢 | | メジャー | | ブール値 | | ディメンションとメジャー | | 通貨 | USD EUR GBP | 測定 | | 日付パート | 日 週 月 年 四半期 | ディメンションと測定 | | Distance | キロメートル メートル ヤード フィート | 測定 | | 時間 | 秒 分 時 日 | 測定 | | 識別子 | | ディメンションと測定 | | ロケーション | ZIP コード 国 State 市 | ディメンションと測定 | | 組織 | | ディメンション | | パーセンテージ | | 測定 | | 個人 | | ディメンション | # Quick Sight トピックの共有 | | | --- | |  適用対象: Enterprise Edition  | | | | --- | |    対象者: Amazon Quick 管理者と作成者  | トピックを作成したら、組織内の他のユーザーと共有することができます。トピックを共有すると、ユーザーはトピックを選択し、検索バーでトピックについて質問できます。トピックをユーザーと共有した後、トピックを変更できるユーザーを指定する権限をユーザーに割り当てることができます。 **トピックを共有するには** 1. クイックスタートページで、左側の**トピック**を選択します。 1. 開いた [**Topics**] ページで、共有するトピックを開きます。 1. 開いたページで、右上の [**Share**] を選択します。 1. 開いた [**Share topic with users**] ページで、トピックを共有するユーザーを選択します。 検索バーを使用して E メールアドレスでユーザーを検索できます。 1. [**Permission**] 列の [**Viewer**] または [**Co-owner**] のいずれかを選択し、ユーザーへのアクセス許可を割り当てます。 これらのアクセス許可の詳細については、次のセクション、「[Amazon Quick Sight トピックのアクセス許可の管理](topics-sharing-permissions.md)」を参照してください。 1. ユーザーの選択が完了したら、[**Share**] を選択します。 # Amazon Quick Sight トピックのアクセス許可の管理 組織内の他のユーザーとトピックを共有する場合、トピックを変更できるユーザーを制御できます。これを行うには、どのユーザーが閲覧者であり、共同所有者であるかを指定します。ビュー*ワー*は、リストからトピックを選択すると検索バーにトピックを表示できますが、トピックデータを変更することはできません。*共同所有者*は検索バーでトピックを表示でき、トピックを変更することもできます。 **トピックのアクセス権限をユーザーに割り当てるには** 1. クイックスタートページから、**トピック**を選択します。 1. 開いた**トピック**ページで、アクセス許可を管理するトピックを開きます。 1. 開いたトピックページで、右上の [**Share**] を選択します。 1. 開いた [**Share topic with users**] ページで、[**Manage topic access**] を選択します。 1. 開いた [**Manage topic permissions**] ページで、アクセスを管理するユーザーを検索し、[**Permission**] で、以下のいずれかのオプションを選択します。 + ユーザーがトピックを表示および変更できるようにするには、[**Co-Owner**] を選択します。 + ユーザーがトピックのみを表示できるようにするには、[**Viewer**] を選択します。 # Quick Sight トピックのパフォーマンスとフィードバックの確認 | | | --- | |  適用対象: Enterprise Edition  | | | | --- | |    対象者: Amazon Quick 管理者と作成者  | トピックを作成してユーザーと共有したら、そのトピックのパフォーマンスを確認できます。誰かがトピックを使用して質問したり、レスポンスの正常性に関するフィードバックを提供したりすると、トピック**の概要**と**ユーザーアクティビティ**のタブに記録されます。 トピックの [**Summary**] タブで、7 日から 1 年の期間で、時間の経過に伴う質問数の履歴データを表示できます。また、肯定的、否定的、またはフィードバックのない質問や、回答できなかった質問のディストリビューションも確認できます。 [**User Activity**] タブで、ユーザーがした質問と、ユーザーが残した肯定的または否定的なフィードバックとコメントのリストを表示できます。 この情報を確認すると、トピックがユーザーのニーズを満たしているかどうかを判断できます。例えば、ユーザーから多くの否定的なフィードバックを受けているトピックがあるとします。ユーザーアクティビティを確認すると、複数のユーザーが間違ったデータを示す質問にコメントを残していることがわかります。それに応じて、彼らがした質問を調べて、予想しなかった用語を使用していることに気づきます。その用語をトピックの正しいフィールドにシノニムとして追加することにしました。時間が経つと、肯定的なフィードバックが増加していることに気付きます。 ## トピックのパフォーマンスの確認 以下の手順に従って、トピックのパフォーマンスを表示します。 **トピックのパフォーマンスを表示するには** 1. クイックスタートページで、左側の**トピック**を選択します。 1. 開いた [**Topics**] ページで、表示するトピックを開きます。 トピックが開き、[**Statistics**] セクションには、トピックの統計情報が表示されます。 1. (オプション) グラフに表示される履歴データの量を変更するには、[**7 日間**]、[**30 日間**]、[**90 日間**]、[**120 日間**]、または [**12 ヶ月間**] のいずれかのオプションを選択します。 1. (オプション) 回答できなかった質問をデータから削除するには、[**Include Unanswerable data**] をクリアします。 1. (オプション) データからフィードバックを受け取らなかった質問を削除するには、[**Include No feedback data**] をクリアします。 ## トピックの質問とフィードバックの確認 トピックの質問とフィードバックを確認するには、次の手順を使用します。 **トピックの質問とフィードバックを確認するには** 1. クイックスタートページで、**トピック**を選択します。 1. 開いた [**Topics**] ページで、フィードバックを表示するトピックを開きます。 1. 開いたトピックのページで、[**User Activity**] タブを選択します。 トピックのユーザーアクティビティが表示されます。上部には、回答された質問の総数と、回答可能な、および回答不可能な質問の数が、それぞれ表示されます。同時に、肯定的および否定的に評価された質問の割合も表示されます。加えて、曖昧さが解消された質問の割合も確認することが可能です。これは、質問が入力され、その中に含まれる単語の 1 つが、トピックのフィールドにマッピングされたことを意味します。 これらの統計情報のいずれかを選択すると、質問のリストをフィルタリングすることができます。 1. (オプション) 質問についてユーザーが残したコメントを表示するには、質問の右側にある下向き矢印をクリックします。 コメントは左側に表示されます。 1. (オプション) 質問の回答に使用されるフィールドを表示するには、質問の右側にある下向きの矢印をクリックします。 使用されるフィールドは右側に表示されます。フィールド名を選択して、メタデータを編集します。 1. (オプション) 曖昧さが解消された質問を表示するには、語句が赤色で強調された質問の右側で、下向き矢印を選択します。 その語句に関する説明、および曖昧さ解消に使用されたフィールドが表示されます。フィールドに類義語を追加するには、**[Add synonyms]** (類義語を追加) を選択します。 1. (オプション) 質問の応答方法を表示するには、リストの質問の横にある**表示**を選択します。 1. (オプション) 質問のリストをフィルタリングするには、右側にある **[Filter by]** (フィルター条件) を選択し、表示されるオプションのいずれかによりフィルタリングします。 + [**See all questions**] - このオプションでは、すべてのフィルターが削除され、トピックが受信したすべての質問が表示されます。 + **Answerable** – このオプションは、回答が行えた質問のリストをフィルタリングします。回答可能な質問とは、Q による応答が可能だった質問です。 + [**Unanswerable**] - このオプションは、回答できなかった質問のリストをフィルタリングします。回答できない質問は、Q が回答できなかった質問です。 + **Disambiguated** – このオプションは、曖昧さが解消された質問、つまりユーザーが手動でフィールドをマッピングした質問のリストをフィルタリングします。 + [**No feedback**] - このオプションは、フィードバックを受け取らなかった質問のリストをフィルタリングします。 + [**Negative**] - このオプションは、否定的なフィードバックを受け取った質問のリストをフィルタリングします。 + [**Positive**] - このオプションは、肯定的なフィードバックを受け取った質問のリストをフィルタリングします。 + [**No comments**] - このオプションは、ユーザーからコメントを受け取っていない質問のリストをフィルタリングします。 + [**Has comments**] - このオプションは、ユーザーからコメントを受け取った質問のリストをフィルタリングします。 + **User** – このオプションは、入力した特定のユーザー名を持つユーザーにより回答された、質問のリストをフィルタリングします。 # Quick Sight トピックインデックスの更新 | | | --- | |  適用対象: Enterprise Edition  | | | | --- | |    対象者: Amazon Quick 管理者と作成者  | トピックを作成すると、Quick Sight はそのトピック内のデータの定義を含むインデックスを作成、保存、維持します。このインデックスは Quick Sight の作成者には公開されません。これは、トピックに含まれるデータセットのコピーでもありません。メトリクスはインデックス化されません。たとえば、整数として保存されたメジャーはインデックス化されません。 トピックインデックスは、トピックに含まれるフィールドの一意の文字列値のインデックスです。このインデックスは、正しい回答を生成し、誰かが質問したときにオートコンプリート提案を行い、用語の列またはデータ値へのマッピングを提案するために使用されます。 トピックインデックスを更新するには、トピック内のデータセットを更新します。トピック内のすべてのデータセットを更新することも、個々のデータセットを更新することも手動でできます。また、データセット更新履歴を表示して過去の更新をモニタリングし、トピック内のすべてのデータセットに対して定期的な更新スケジュールを設定することもできます。SPICE データセットの場合、トピックインデックスの更新スケジュールを SPICE 更新スケジュールに同期できます。SPICE 更新スケジュールの設定に関する詳細については、[スケジュールに基づいたデータセットの更新](refreshing-imported-data.md#schedule-data-refresh) を参照してください。 **注記** 現在、時間単位の更新スケジュールはサポートされていません。更新スケジュールを設定して、トピック内のデータセットを 1 日に 1 回まで更新できます。 トピックインデックスを定期的に更新して、最新の定義と値が記録されるようにすることをお勧めします。トピックインデックスの更新には、トピックに含まれるデータセットの数とサイズに応じて、約 15～30 分かかります。 **トピックインデックスを更新するには** 1. クイックスタートページで、**トピック**を選択します。 1. 開いた [**Topics**] ページで、更新するトピックを開きます。 トピックは、[**Summary**] タブを開きます。トピックに含まれるデータセットがこのページ下部に表示されます。また、トピックが最後に更新された時刻も右上に表示されます。 1. 右上の [**Refreshed**] を選択して、トピックインデックスを更新し、その後 [**Refresh data**] を選択します。この操作手動でを行うと、トピック内のすべてのデータセットが更新されます。 トピック内の個々のデータセットを更新する方法の詳細については、「[Quick Sight トピックのデータセットの更新](topics-data-refresh.md)」を参照してください。 # Amazon Quick Sight APIs | | | --- | |  適用対象: Enterprise Edition  | | | | --- | |    対象者: Amazon Quick デベロッパー  | このセクションでは、Amazon Quick Sight コマンドラインインターフェイス (CLI) を使用して Quick Sight トピックを操作する方法について説明します。 **前提条件** 開始する前に、Quick Sight API オペレーションを呼び出すためのアクセス権を CLI ユーザーに付与する AWS Identity and Access Management (IAM) ロールがあることを確認してください。次の表は、特定の API オペレーションを使用するために、IAM ポリシーに追加するべきアクセス許可を示しています。すべてのトピック API オペレーションを使用するには、表に記載されているすべてのアクセス許可を追加します。 | API オペレーション: | IAM ポリシー | | --- | --- | | `CreateTopic` | `quicksight:CreateTopic` `quicksight:PassDataSet` | | `ListTopics` | `quicksight:ListTopics` | | `DescribeTopic` | `quicksight:DescribeTopic` | | `DescribeTopicPermissions` | `quicksight:DescribeTopicPermissions` | | `DescribeTopicRefresh` | `quicksight:DescribeTopicRefresh` | | `DeleteTopic` | `quicksight:DeleteTopic` | | `UpdateTopic` | `quicksight:UpdateTopic` `quicksight:PassDataSet` | | `UpdateTopicPermissions` | `quicksight:UpdateTopicPermissions` | | `CreateTopicRefreshSchedule` | `quicksight:CreateTopicRefreshSchedule` | | `ListTopicRefreshSchedules` | `quicksight:ListTopicRefreshSchedules` | | `DescribeTopicRefreshSchedule` | `quicksight:DescribeTopicRefreshSchedule` | | `UpdateTopicRefreshSchedule` | `quicksight:UpdateTopicRefreshSchedule` | | `DeleteTopicRefreshSchedule` | `quicksight:DeleteTopicRefreshSchedule` | | `BatchCreateTopicReviewedAnswer` | `quicksight:BatchCreateTopicReviewedAnswer` | | `BatchDeleteTopicReviewedAnswer` | `quicksight:BatchDeleteTopicReviewedAnswer` | | `ListTopicReviewedAnswers` | `quicksight:ListTopicReviewedAnswers` | 次の例では、ユーザーに `ListTopics` API オペレーションの使用を許可する IAM ポリシーを示します。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "quicksight:ListTopics" ], "Resource": "*" } ] } ``` ------ Quick Sight APIs を使用して Quick Sight トピックを作成するアクセス許可を設定したら、次のトピックを使用して Quick Sight トピック APIs。 **Topics** + [Quick Sight APIs](topic-cli-examples.md) + [Quick Sight CLI を使用して Quick Sight トピックの更新スケジュールを設定する](topic-refresh-apis.md) + [Quick Sight トピックを 内および 間でコピーして移行する AWS アカウント](topic-cli-walkthroughs.md) + [Quick Sight APIs](topic-reviewed-answer-apis.md) # Quick Sight APIs 次の の例では、新しいトピックを作成します。 ``` aws quicksight create-topic --aws-account-id AWSACCOUNTID --topic-id TOPICID --topic TOPIC ``` 次のコマンドで CLI スケルトンファイルを使用して、新しいトピックを作成することもできます。CLI スケルトンファイルの詳細については、*Amazon Quick Sight デベロッパーガイド*[の「CLI スケルトンファイル](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)の使用」を参照してください。 ``` aws quicksight create-topic --cli-input-json file://createtopic.json ``` 新しいトピックを作成すると、データセットの更新設定はトピックにコピーされません。新しいトピックのトピック更新スケジュールを設定するために、`create-topic-refresh-schedule` API 呼び出しを実行できます。CLI を使用したトピック更新スケジュールの設定の詳細については、「[Quick Sight CLI を使用して Quick Sight トピックの更新スケジュールを設定する](topic-refresh-apis.md)」を参照してください。 最初のトピックを作成したら、トピックの概要を更新、削除、一覧表示、またはリクエストできます。 次の の例では、トピックを更新します。 ``` aws quicksight update-topic --aws-account-id AWSACCOUNTID --topic-id TOPICID --topic TOPIC ``` 次のコマンドで CLI スケルトンファイルを使用してトピックを更新することもできます。CLI スケルトンファイルの詳細については、*Amazon Quick Sight デベロッパーガイド*[の「CLI スケルトンファイル](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)の使用」を参照してください。 ``` aws quicksight update-topic --cli-input-json file://updatetopic.json ``` 次の の例では、クイックアカウントのすべてのトピックのリストを示します。 ``` aws quicksight list-topics --aws-account-id AWSACCOUNTID ``` 次の の例では、トピックを削除します。 ``` aws quicksight delete-topic --aws-account-id AWSACCOUNTID --topic-id TOPICID ``` 次の例では、トピックの設定方法に関する情報を提供します。 ``` aws quicksight describe-topic --aws-account-id AWSACCOUNTID --topic-id TOPICID ``` 次のコマンドは、トピックのアクセス許可を更新します。 ``` aws quicksight update-topic-permissions --aws-account-id AWSACCOUNTID --topic-id TOPICID --grant-permissions Principal=arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/USERNAME,Actions=quicksight:DescribeTopic --revoke-permissions Principal=arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/USERNAME,Actions=quicksight:DescribeTopic ``` `grant-permissions` パラメータを使用して、クイックアカウントユーザーに読み取りおよび作成者のアクセス許可を付与します。アカウントユーザーに読み取り許可を付与するには、次の値を入力します: `"quicksight:DescribeTopic"` アカウントユーザーにアクセス許可を付与するには、次の値を入力します: + `"quicksight:DescribeTopic"` + `"quicksight:DescribeTopicRefresh"` + `"quicksight:ListTopicRefreshSchedules"` + `"quicksight:DescribeTopicRefreshSchedule"` + `"quicksight:DeleteTopic"` + `"quicksight:UpdateTopic"` + `"quicksight:CreateTopicRefreshSchedule"` + `"quicksight:DeleteTopicRefreshSchedule"` + `"quicksight:UpdateTopicRefreshSchedule"` + `"quicksight:DescribeTopicPermissions"` + `"quicksight:UpdateTopicPermissions"` `RevokePermissions` パラメータは、アカウントユーザーに付与されているすべての許可を取り消します。 次のコマンドは、トピックからのすべてのアクセス許可を記述します。 ``` aws quicksight describe-topic-permissions --aws-account-id AWSACCOUNTID --topic-id TOPICID ``` Quick Sight トピックを作成したら、Amazon Quick Sight APIs を使用して[トピックの更新スケジュールを設定し](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-refresh-apis)、[Quick Sight トピックをアカウント内またはアカウント間で移行](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-cli-walkthroughs)し、[レビュー済みの回答を作成できます](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-reviewed-answer-apis)。 # Quick Sight CLI を使用して Quick Sight トピックの更新スケジュールを設定する 次のコマンドは、トピックの更新スケジュールを作成します。 ``` aws quicksight create-topic-refresh-schedule --aws-account-id AWSACCOUNTID --topic-id TOPICID --dataset-arn DATASETARN --refresh-schedule REFRESHSCHEDULE ``` トピックの更新スケジュールを作成したら、トピックの更新スケジュールの更新、削除、一覧表示、または概要のリクエストを行うことができます。 次のコマンドは、トピックの更新スケジュールを更新します。 ``` aws quicksight update-topic-refresh-schedule --aws-account-id AWSACCOUNTID --topic-id TOPICID --dataset-id DATASETID --refresh-schedule REFRESHSCHEDULE ``` 次の の例では、トピックに設定されたすべての更新スケジュールのリストを示します。 ``` aws quicksight list-topic-refresh-schedules --aws-account-id AWSACCOUNTID --topic-id TOPICID ``` 次の例では、トピック更新スケジュールを削除します。 ``` aws quicksight delete-topic-refresh-schedule --aws-account-id AWSACCOUNTID --topic-id TOPICID --dataset-id DATASETID ``` 次の例では、トピック更新スケジュールの設定方法に関する情報を提供します。 ``` aws quicksight describe-topic-refresh-schedule --aws-account-id AWSACCOUNTID --topic-id TOPICID --dataset-id DATASETID ``` # Quick Sight トピックを 内および 間でコピーして移行する AWS アカウント Quick Sight コマンドラインインターフェイス (CLI) を使用して、Quick Sight トピックをあるアカウントから別のアカウントに移行できます。複数のダッシュボード、名前空間、またはアカウントに同じトピックを手動でレプリケートする代わりに、Quick Sight CLI を使用して同じトピックを繰り返し再利用できます。この機能を使用すると、Quick Sight 作成者の時間を節約し、複数のダッシュボードにまたがるダッシュボードリーダー向けに標準化されたトピックエクスペリエンスを作成できます。 Quick Sight CLI を使用してトピックを移行するには、次の手順を使用します。 **トピックを別のアカウントに移行するには** 1. まず、移行するトピックを特定します。`list-topics` API コマンドを使用して、クイックアカウント内のすべてのトピックのリストを表示できます。 ``` aws quicksight list-topics --aws-account-id AWSACCOUNTID ``` 1. トピックのリストを取得したら、移行するトピックを見つけ、トピックの設定の JSON 構造を受信するための`describe-topic`呼び出しを行います。 ``` aws quicksight describe-topic --aws-account-id AWSACCOUNTID --topic-id TOPICID ``` `describe-topic` API レスポンスの例を次に示します。 ``` { "Status": 200, "TopicId": "TopicExample", "Arn": "string", "Topic": [ { "Name": "{}", "DataSets": [ { "DataSetArn": "{}", "DataSetName": "{}", "DataSetDescription": "{}", "DataAggregation": "{}", "Filters": [], "Columns": [], "CalculatedFields": [], "NamedEntities": [] } ] } ], "RequestId": "requestId" } ``` 1. JSON レスポンスを使用して、他のクイックアカウントの新しい`create-topic`呼び出しに入力できるスケルトンファイルを作成します。スケルトンファイルを使用して API コールを行う前に、新しいトピックを追加する AWS アカウント ID とデータセット ID と一致するように、スケルトンファイルの AWS アカウント ID とデータセット ID を変更してください。CLI スケルトンファイルの詳細については、*Amazon Quick Sight デベロッパーガイド*[の「CLI スケルトンファイル](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)の使用」を参照してください。 ``` aws quicksight create-topic --aws-account-id AWSACCOUNTID \ --cli-input-json file://./create-topic-cli-input.json ``` Quick Sight API を`create-topic`呼び出すと、新しいトピックがアカウントに表示されます。新しいトピックが存在することを確認するには、Quick Sight API を`list-topics`呼び出します。複製されたソーストピックに検証済みの回答が含まれている場合、その回答は新しいトピックに移行されません。元のトピックに設定されている検証済みの回答すべてのリストを表示するには、`describe-topic` API コールを使用します。 # Quick Sight APIs Quick Sight トピックを作成したら、Quick Sight APIs を使用して、トピックの再開された回答を作成、一覧表示、更新、削除できます。 以下のコマンドは、Quick Sight トピックに対して最大 100 個のレビュー済み回答を作成します。 ``` aws quicksight batch-create-topic-reviewed-answer \ --topic-id TOPICID \ --aws-account-id AWSACCOUNTID \ —answers ANSWERS ``` 次のコマンドを使用して、CLI スケルトンファイルから複数のレビュー済みの回答を一括作成することもできます。CLI スケルトンファイルの詳細については、*Amazon Quick Sight デベロッパーガイド*[の「CLI スケルトンファイル](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)の使用」を参照してください。 ``` aws quicksight batch-create-topic-reviewed-answer \ --cli-input-json file://createTopicReviewedAnswer.json ``` 以下のコマンドは、Quick Sight トピックでレビューされたすべての回答を一覧表示します。 ``` aws quicksight list-topic-reviewed-answers \ --aws-account-id AWSACCOUNTID \ --topic-id TOPICID \ ``` 次のバッチ例では、1 つのトピックから最大 100 件のレビュー済みの回答を削除します。 ``` aws quicksight batch-delete-topic-reviewed-answer \ --topic-id TOPICID \ --aws-account-id AWSACCOUNTID \ —answer-ids: ["AnswerId1, AnswerId2…"] ``` 次のコマンドを使用して、CLI スケルトンファイルから複数のレビュー済みの回答を一括作成することもできます。CLI スケルトンファイルの詳細については、*Amazon Quick Sight デベロッパーガイド*[の「CLI スケルトンファイル](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)の使用」を参照してください。 ``` aws quicksight batch-delete-topic-reviewed-answer \ --cli-input-json file://deleteTopicReviewedAnswer.json ``` レビュー済みの回答を更新するには、 `batch-delete-topic-reviewed-answer` API を使用してトピックから既存の回答を削除します。次に、 `batch-create-topic-reviewed-answer` API を使用して、更新されたレビュー済みの回答をトピックに追加します。