|sf-web-interface|を使用したセマンティックビューの作成と管理¶

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

Snowsight で、ウィザードを使用するか、セマンティックモデル仕様 をアップロードすることで、セマンティックビューを作成できます。

• ウィザードを使用したセマンティックビューの作成

• セマンティックビューを作成する YAML 仕様のアップロード

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

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

1. 次のいずれかの方法でセマンティックビューにアクセスします。

   • データベースオブジェクトエクスプローラー:

     1. Snowsight で Data » Databases を選択します。

     2. セマンティックビューを含むデータベースとスキーマを選択します。

     3. Semantic views を選択します。

     4. セマンティックビューを選択します。

     5. Semantic information タブを選択します。

   • Cortex Analyst:

     1. Snowsight で AI & ML » Cortex Analyst を選択します。

     2. Semantic views タブを選択します。

     3. Select database to see semantic views で、編集するセマンティックビューを含むデータベースとスキーマを選択します。

     4. 編集するセマンティックビューを選択します。

2. セマンティックビューに変更を加えます。次のタイプの変更を行うことができます。

   • セマンティックビューの名前や説明を変更するには

     1. セマンティックビューの名前の横にある Edit を選択します。

     2. 名前または説明に変更を加えます。

     3. Apply を選択します。

   • セマンティックビューに新しい論理テーブルを追加するには

     1. データベースオブジェクトエクスプローラーで + Logical Table を選択するか、Cortex Analyst で + を選択します。

     2. ウィザードの Select a table ステップで次を実行します。

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

        2. Next を選択します。

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

        1. ビューに含める列を選択します。

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

        2. Generate logical table を選択します。

   • セマンティックビューで論理テーブルの名前、説明、同義語、または主キーを変更するには

     1. データベースオブジェクトエクスプローラーの論理テーブル名の横にある » Edit Logical Table、または Cortex Analyst の論理テーブル名の横にある Edit を選択します。

     2. 名前、説明、同義語、主キーを変更します。

        説明や同義語を指定していない場合は、Generate fields を選択するとこれらのフィールドに自動入力できます。

     3. Save を選択します。

   • ファクト、ディメンション、またはメトリックを追加するには

     1. 新しいアイテムを追加するフォームを開きます。

        • データベースオブジェクトエクスプローラーで、 を選択してから、Fact、Dimension、または Metric を選択します。

        • Cortex Analyst で、Facts、Dimensions、または Metrics の横にある + を選択します。

     2. 新しいファクト、ディメンション、またはメトリックに関する情報を入力し、Add を選択します。

   • ファクト、ディメンション、またはメトリックを変更または削除するには

     1. Facts、Dimensions、または Metrics を選択して、ファクト、ディメンション、またはメトリックのリストを表示します。

     2. 変更するファクト、ディメンション、またはメトリックについて

        • Edit を選択してアイテムを変更します。

        • 、»、Remove fact、Remove dimension、または:ui:Remove metric を選択してアイテムを削除します。

   • 関係を追加するには

     1. 新しいアイテムを追加するフォームを開きます。

        • データベースオブジェクトエクスプローラーで、+ Relationship を選択します。

        • Cortex Analyst で、Relationships の横にある + を選択します。

     2. 関係の名前を入力し、関係内のテーブルを選択して、テーブルの結合に使用する列を選択します。

     3. Add を選択します。

3. このビューで Cortex Analyst を使用する予定がある場合は、次のことを考慮します。

   • Verified Queries セクションにサンプルクエリを追加します。このセクションは Cortex Analyst でのみ利用可能です。

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

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

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

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

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

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

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

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

4. Save を選択します。

セマンティックビューを使用する権限の別のロールへの付与¶

セマンティックビューの表示とクエリの権限を別のロールに付与するには

1. 次のいずれかの方法でセマンティックビューにアクセスします。

   • データベースオブジェクトエクスプローラー:

     1. Snowsight で Data » Databases を選択します。

     2. セマンティックビューを含むデータベースとスキーマを選択します。

     3. Semantic views を選択します。

     4. セマンティックビューを選択します。

     5. » Share を選択します。

   • Cortex Analyst:

     1. Snowsight で AI & ML » Cortex Analyst を選択します。

     2. Semantic views タブを選択します。

     3. セマンティックビューを選択します。

     4. Share を選択します。

2. セマンティックビューの表示とクエリの権限を付与するロールを選択します。

3. Done を選択します。

これによりセマンティックビューに関する SELECT と REFERENCES の権限を選択したロールに付与します。

セマンティックビューのクエリ¶

データベースオブジェクトエクスプローラーでセマンティックビューを表示している場合は、 » Query with SQL を選択すると、ワークシートを開いてそのビューのクエリを構築することができます。

クエリを構築する方法については、セマンティックビューのクエリ をご参照ください。

セマンティックビュー作成のベストプラクティス¶

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

トラブルシューティング¶

• セマンティックビューがビューのリストに記載されていない場合は、モデルのリスト（ページ自体ではなく）を更新します。

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

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

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