Cortex Analyst Semantic View Generatorの使用法

Cortex Analyst Semantic View Generatorは、 セマンティックビュー を作成・管理するためのグラフィカルユーザーインターフェイス (GUI) を提供します。このウィザードは、ビジネス・セマンティクスの定義プロセスをガイドし、 SQL に慣れていないユーザーでもアクセスできるようにします。

YAML でのジェネレーターの使用とセマンティック・モデルの管理の詳細については、以下のトピックを参照してください。

セマンティックビューの作成

Cortex Analyst Semantic View Generatorを使用して、新しいセマンティックビューを作成します。

  1. Snowsight で、 AI & ML を選択します。

  2. Cortex Analyst タイルを見つけ、 Try を選択します。 Select a semantic model ウィンドウが開きます。

  3. Role and warehouse 中:

    1. セマンティックビューを所有すべきロールを選択します。

    2. セマンティックビューのクエリに使用するウェアハウスを選択します。

  4. Select from の下で、 Semantic Views を選択します。

  5. No Database selected と表示されたメニューから、セマンティック・ビューを作成したいデータベースとスキーマを選択します。

  6. Create new を選択します。Semantic View Generatorウィザードが開きます。

  7. ウィザードの Description ステップで:

    1. Location to store から、モデルを保存するデータベースとスキーマを選択します。

    2. Name に、セマンティックモデルの名前を入力します。

      文字またはアンダースコアで始まり、文字、数字、アンダースコア、ドル記号のみを含む名前を指定する必要があります。

    3. (オプション) Description で、あなたのセマンティックモデルが利用可能にするデータを記述し、ユーザーが質問できるタイプを記述します。

    4. Next: Select tables を選択します。

  8. ウィザードの Select tables ステップで:

    1. Find tables and views タブで、セマンティックビューで使用したいデータを含むテーブルまたはビューを選択します。

      少なくとも1つのテーブルまたは表示を選択する必要があります。

      パフォーマンスを向上させるために、10以上のテーブルを選択しないでください。

      選択したテーブルとビューのリストを表示するには、 Selected タブを選択します。

    2. Next: Select columns を選択します。

  9. ウィザードの Select columns ステップで:

    1. モデルに含める列を選択します。

      テーブルまたは表示内のすべての列を選択するには、テーブルまたはビューを選択します。

      パフォーマンス向上のため、50列以上は選択しないでください。

    2. Create and Save を選択します。

      Cortex Analyst ウィンドウが開き、作成したセマンティックモデルの詳細が表示されます。

  10. Logical tables 中:

    1. 各テーブルまたはビューに定義されているファクト、ディメンジョン、およびメトリクスを確認します。

    2. ビジネスに適した名称と説明を提供します。

    3. 必要なファクト、ディメンジョン、メトリクスを追加します。

  11. Relationships 中:

    1. ジェネレーターによって定義された関係を確認します。

    2. 必要に応じてリレーションシップのプロパティを変更します。

    3. 必要なリレーションシップを追加してください。

  12. セマンティックビューに変更を加えた場合は、 Cortex Analyst ウィンドウ右上の Save を選択します。

セマンティックビューの編集

セマンティックビューを編集するには:

  1. Snowsight で、 AI & ML を選択します。

  2. Cortex Analyst タイルを見つけ、 Try を選択します。 Select a semantic model ウィンドウが開きます。

  3. Role and warehouse 中:

    1. セマンティックビューを所有するロールを選択します。

    2. セマンティックビューのクエリに使用するウェアハウスを選択します。

  4. Select from の下で、 Semantic Views を選択します。

  5. データベースメニューから、編集したいセマンティックビューを含むデータベースとスキーマを選択します。

  6. 編集したいセマンティックビューを選択し、 Open を選択します。

  7. セマンティックビューに変更を加えます。できること:

    • 説明や基本情報を修正します。

    • データソースを追加または削除します。

    • 列の選択を変更します。

    • リレーションシップの更新

    • ファクト、ディメンジョン、メトリクスの追加、変更、削除を行います。

  8. この表示でCortex Analystを使用する場合は、以下を考慮してください。

    • Verified Queries セクションにサンプルクエリを追加します。

      • これらは、Cortex Analystがセマンティックビューの使い方を理解するのに役立つクエリ例です。

      • データの一般的な使用ケースを表すクエリを追加します。

    • テーブル、ファクト、ディメンジョン、またはメトリクスの同義語を追加します。

      • これらは、ユーザーがクエリで使用する可能性のある代替用語です。

      • 同義語は、 Cortex Analyst が、ユーザーの質問を正しく解釈するのに役立ちます。

    • カスタム指示を追加します。

      • これらは、データをどのように解釈すべきかについての追加的なコンテキストを提供します。

      • 考慮すべきビジネスルールや制約を含めてください。

  9. Cortex Analyst ウィンドウ右上の Save を選択します。

Cortex Analyst Semantic View Generatorのベストプラクティス

  • 明確な説明を提供します:

    • すべての名称と説明にはビジネス用語を使用してください。

    • 技術的な知識がないユーザーでも理解できるように、説明を詳しくしてください。

  • 代表的なユーザーの質問を含みます:

    • モデルジェネレーターがあなたの意図をよりよく理解するのに役立つ質問を含めてください。

    • 質問の仕方のバリエーションを含めてください。

  • 生成された提案を注意深く検討してください:

    • 質問がユースケースに関連していることを確認してください。

    • 提案された関係があなたのビジネスの理解に合致していることを確認してください。

  • 実際の問題でテストします:

    • セマンティックビューを作成したら、実際のビジネス質問でテストしてみましょう。

    • モデルがこれらの質問をどの程度サポートしているかに基づいて、セマンティックビューを絞り込みます。

  • セマンティックビューの開発を繰り返す:

    • シンプルなスタースキーマから始めましょう。

    • 中核となるテーブルと測定基準から始め、その後拡張していきます。シンプルにするために、3つのテーブルをお勧めします。

    • ビジネスユーザーからフィードバックを得て、セマンティックビューを改善しましょう。

トラブルシューティング

  • Cortex Analyst Semantic View Generatorのビューリストにセマンティックビューが表示されていない場合は、(ページ自体ではなく)モデルのリストを更新してください。

  • セマンティックビューのリレーションシップでエラーが発生した場合は、これらのリレーションシップが実際のデータ構造と一致していることを確認してください。

  • クエリが遅い場合は、テーブルや列の数を減らしてください。

  • Cortex Analyst に、セマンティック・ビューを使用した際に予期しない結果が表示された場合は、セマンティック・ビューのファクト、ディメンジョン、メトリクスを見直してください。