構造化データストアに接続してナレッジベースを作成する

テーブルの説明を追加するには、tables配列に QueryGenerationTable オブジェクトを含めます。そのオブジェクトで、次の例のように、 nameフィールドにテーブルの名前を指定し、 descriptionフィールドに説明を指定します。

{
    "name": "database.schema.tableA",
    "description": "Description for Table A"
}

列の説明を追加するには、tables配列に QueryGenerationTable オブジェクトを含めます。そのオブジェクトで、 nameフィールドにテーブルの名前を指定し、QueryGenerationColumn の配列にマッピングされる columnsフィールドを含めます。QueryGenerationColumn オブジェクトには、次の例のように、 name フィールドに列の名前、 descriptionフィールドに説明を含めます。

{
    "name": "database.schema.tableA",
    "columns": [
        {
            "name": "Column A",
            "description": "Description for Column A"
        }
    ]
}

次の例のように、テーブルと列の両方の説明を追加できます。

{
    "name": "database.schema.tableA",
    "description": "Description for Table A",
    "columns": [
        {
            "name": "columnA",
            "description": "Description for Column A"
        }
    ]
}

INCLUDE – SQL の生成時にコンテキストとして含まれるのは、指定したテーブルまたは列のみです。

EXCLUDE – 指定したテーブルまたは列は、SQL の生成時にコンテキストとして除外されます。

テーブルを含めるか除外するには、tables配列に QueryGenerationTable オブジェクトを含めます。そのオブジェクトで、次の例のように、 nameフィールドにテーブルの名前を指定し、 inclusion フィールドにテーブルを含めるか除外するかを指定します。

{
    "name": "database.schema.tableA",
    "inclusion": "EXCLUDE"
}

クエリエンジンは、SQL を生成するための追加コンテキストTable Aに を追加しません。

列を含めるか除外するには、tables配列に QueryGenerationTable オブジェクトを含めます。そのオブジェクトで、 nameフィールドにテーブルの名前を指定し、QueryGenerationColumn の配列にマッピングされる columnsフィールドを含めます。QueryGenerationColumn オブジェクトで、次の例のように、 name フィールドに列の名前を含め、inclusionフィールドに含めるか除外するかを指定します。

{
    "name": "database.schema.tableA",
    "columns": [
        {
            "name": "database.schema.tableA.columnA",
            "inclusion": "EXCLUDE"
        }
    ]
}

SQL の生成では、SQL の生成時にコンテキストColumn ATable A内の が無視されます。

次の例のように、包含または除外を指定するときにテーブルと列を組み合わせることができます。

{
    "name": "database.schema.tableA",
    "inclusion": "INCLUDE",
    "columns": [
        {
            "name": "database.schema.tableA.columnA",
            "inclusion": "EXCLUDE"
        }
    ]
}

SQL 生成には が含まれますがTable A、SQL 生成のコンテキストを追加すると、そのColumn A内部は除外されます。

naturalLanguage – 自然言語でのクエリの例。

sql – 自然言語クエリに対応する SQL クエリ。