列の説明と使用方法のカスタマイズ

  • リリースバージョン: Australia
  • 更新日 2026年04月17日
  • 所要時間:3分
  • 更新セットを介してインスタンス間でカスタマイズを 転送 できるように、セマンティック列構成テーブルにカスタム列の説明と使用方法の説明を作成します。

    始める前に

    必要なロール:sn_query_gen.admin 以上

    このタスクについて

    クエリ生成セマンティックレイヤーは、列の説明と使用方法を使用して、各フィールドが表す内容とそのクエリ方法を AI が理解できるようにします。sys_documentationテーブルから自動生成された説明を上書きし、クエリのビルドをガイドする使用手順を追加できます。

    この手順では、セマンティック列構成テーブルを使用します。この方法で行われたカスタマイズは、更新セットを介してインスタンス間で転送でき、ディメンションテーブルで直接設定された説明と使用方法を上書きできます。より単純な単一インスタンステストの場合は、代わりにディメンション [sn_query_gen_dimension] テーブルで [セマンティックラベル] フィールドと [セマンティック使用方法の説明] フィールドを直接編集できます。このような変更は、プラグインのアップグレードに含まれるディメンションテーブルへの変更によって上書きされる場合があります。

    カスタムの説明を提供したり、クエリガイダンスの使用方法を追加したり、セマンティックレイヤーからテーブル全体を削除せずに特定の列を非アクティブ化したりする場合は、列構成を使用します。

    手順

    1. 移動先 クエリ生成 > セマンティック列構成.
    2. [新規] を選択します。
    3. [セマンティック列構成] フォームで、次の情報を入力します。
      表 : 1. [セマンティック列構成] フォーム
      フィールド 説明
      テーブル名 列が属するテーブル。セマンティックレイヤーにアクティブなエンティティが必要です。
      列名 構成する列。表示ラベルではなく、データベース列名を使用します。
      セマンティックな説明 列がビジネス用語で表す内容のカスタムの説明。sys_documentationから自動生成された説明を上書きします。最大 2,000 文字。
      セマンティックな使用方法の説明 クエリ生成中にこの列を使用する方法に関する AI へのガイダンス。優先演算子、予期される値の形式、およびフィルタリング動作を含めます。最大 2,000 文字。
      有効 列構成が適用されるかどうか。オフにすると、列は自動生成ステータスに戻ります。
    4. [送信] を選択します。
      構成は、セマンティックレイヤーの対応するディメンションレコードに自動的に同期されます。

    タスクの結果

    カスタム列構成はアクティブであり、この列を含むクエリを処理するときに クエリ生成 によって使用されます。このカスタマイズはセマンティック列構成テーブルに格納されるため、更新セットに含めたり、他のインスタンスに転送したりできます。詳細については、「System update sets」を参照してください。

    列構成

    次の例は、有効な列の説明と使用方法を示しています。

    表 : 2. 列構成の例
    タイプ セマンティックな説明 使用方法の説明
    creation_type 選択肢 データセットがどのように生成されたかを示します。値:「キュレーション済み」(手作業で選択)、「派生」(既存のデータセットから変換)、「合成」(人工的に生成)。 空のままにする:選択値はシステムによって自動的に入力されます
    dataset_creation_date 日付 資産レコードがインスタンスに追加された日時とは無関係で、データセット自体が最初に作成またはコンパイルされた日付。 YYYY-MM-DD 形式の日付演算子 (>=、<=、BETWEEN) を使用します。
    base_datasets 参照 データセットリネージを表す、このデータセットの派生元または構築の基になっているその他の AI データセット資産のリスト。 参照フィールド。元の/ルートデータセットを検索するには、IS EMPTY を使用します。派生データセットを検索するには、IS NOT EMPTY を使用します。

    次のタスク

    クエリ生成でこのフィールドに関連する質問をし、正しいフィルターが生成されていることを確認して、列構成をテストします。