JSON_TABLE - Teradata Database - Teradata Vantage NewSQL Engine - JSON_TABLEは、JSONオブジェクトのすべてのデータまたはそのサブセットに基づいて一時テーブルを作成します。

目的

JSON_TABLEは、JSONオブジェクトのすべてのデータまたはそのサブセットに基づいて一時テーブルを作成します。

構文

json_documents_retrieving_expr

少なくとも2つの列を結果として提供する必要がある問合わせ式。最初の列はJSON文書を識別するIDです。このIDは、出力行を入力行に関連付ける出力行で返されます。エラーが発生した場合は、エラーの原因となった入力行を識別するために使用されます。2番目の列は、JSON文書自身です。他の列を含めることもできますが、JSON文書列の後にする必要があります。追加の列は、入力時から変更されずに出力行で返されます。

これは、json_documents_retrieving_exprの例です。

SELECT id, jsonDoc FROM jsonTable;

これは、追加の列を使用するjson_documents_retrieving_expr問合わせの例です。テーブル演算子によって追加の列が返され、そのまま出力されます。

SELECT id, orderJson, orderDate, orderSite FROM orderJsnTable;

json_documents_retrieving_exprパラメータがNULLの場合、関数の結果は行を含まないテーブルになります。

row_expr_literal

JSONPath構文に準拠するLATIN文字列リテラルまたはUNICODE文字列リテラル。

このパラメータは、json_documents_retrieving_exprの2番目の列で返されるJSON文書に対して評価されるJSONPath問合わせです。

row_expr_literal問合わせは、オブジェクトの配列を返します。配列の各オブジェクトに対して1つの出力行が返されます。

row_expr_literalがNULLの場合は、エラーが報告されます。

column_expr_literal

JSON配列を表わすLATINリテラルまたはUNICODEリテラル。この配列には1つ以上のJSONオブジェクトが含まれ、それぞれがJSON_TABLE演算子が生成する列を定義します。

このパラメータがNULLの場合には、エラーが報告されます。

次の属性は、大文字小文字を区別し、以下と一致する必要があります。

• ordinal
• jsonpath
• type
• fromRoot

AS

correlation_nameの前に指定するオプションのキーワード。

correlation_name

json_documents_retrieving_exprによって参照されるテーブルの別名。

ANSI SQLでは、テーブル別名を相関名と呼びます。範囲変数とも呼ばれます。

column_name

1つ以上の列名のオプション リスト。

機能の説明

JSON_TABLEはJSONインスタンスを受け取り、インスタンスのすべてのデータまたはそのサブセットに基づいた一時テーブルを作成します。JSONインスタンスは、SQL文を使用してテーブルから取得します。JSONPath構文は、JSONインスタンスの取得する部分を定義するために使用します。

戻り値

JSON_TABLEテーブル演算子は、column_expr_literalによって定義される行形式に従って出力行を生成します。そのリテラルは、出力行の列およびそのデータ型を説明します。

JSON_TABLEは出力におけるUDT型とLOB型をサポートしていないので、出力列の型をJSONデータ型にすることはできません。出力テーブルの列のデータ型は、LOB以外の任意の事前定義されたTeradata型にできます。次に、JSON_TABLE出力でサポートされているデータ型を示します。

サポートされるデータ型

ルールと制限

この関数はTD_SYSFNLIBにあります。問合わせ結果のID列には、CLOBを除く任意の数値型または文字型を使用できます。ユーザーがID列を固有にする必要があります。固有ではない場合もJSON_TABLEは失敗しませんが、結果出力のどの行がどのJSON文書からもたらされているかを判別するのが困難になります。

結果は最大行サイズに依存し、問合わせは問合わせの最大許容サイズを超えることができません。