SQLデータのタイプ: 最大長、出力、エラーメッセージに対する変更¶

GET_DDL¶

GET_DDL 関数の呼び出しから返されるメタデータは以下のように変更されます。

SELECT GET_DDL('function', 'udf_varchar(VARCHAR)');

変更前のメタデータ:

CREATE OR REPLACE FUNCTION "UDF_VARCHAR"("G1" VARCHAR(16777216))
RETURNS VARCHAR(16777216)
LANGUAGE SQL
AS '
  ''Hello'' || g1
';

変更後のメタデータ:

CREATE OR REPLACE FUNCTION "UDF_VARCHAR"("G1" VARCHAR)
RETURNS VARCHAR
LANGUAGE SQL
AS '
  ''Hello'' || g1
';

DESCRIBE FUNCTION¶

DESCRIBE FUNCTION ステートメントの返されるメタデータは以下のように変更されます。

DESCRIBE FUNCTION udf_varchar(VARCHAR);

変更前のメタデータ:

+-----------+-------------------+
| property  | value             |
|-----------+-------------------|
| signature | (G1 VARCHAR)      |
| returns   | VARCHAR(16777216) |
| language  | SQL               |
| body      |                   |
|           |   'Hello' || g1   |
|           |                   |
+-----------+-------------------+

変更後のメタデータ:

+-----------+-------------------+
| property  | value             |
|-----------+-------------------|
| signature | (G1 VARCHAR)      |
| returns   | VARCHAR           |
| language  | SQL               |
| body      |                   |
|           |   'Hello' || g1   |
|           |                   |
+-----------+-------------------+

イベントテーブル¶

出力として VARCHAR または BINARY の値を返す新しいユーザー定義関数の場合、 イベントテーブル の RESOURCE_ATTRIBUTES 列にある snow.executable.name 属性は以下のように変更されます。

変更前のメタデータ:

{
  "db.user": "MYUSERNAME",
  "snow.database.id": 13,
  "snow.database.name": "MY_DB",
  "snow.executable.id": 197,
  "snow.executable.name": "UDF_VARCHAR(X VARCHAR):VARCHAR(16777216)",
  "snow.executable.type": "FUNCTION",
  "snow.owner.id": 2,
  "snow.owner.name": "MY_ROLE",
  "snow.query.id": "01ab0f07-0000-15c8-0000-0129000592c2",
  "snow.schema.id": 16,
  "snow.schema.name": "PUBLIC",
  "snow.session.id": 1275605667850,
  "snow.session.role.primary.id": 2,
  "snow.session.role.primary.name": "MY_ROLE",
  "snow.user.id": 25,
  "snow.warehouse.id": 5,
  "snow.warehouse.name": "MYWH",
  "telemetry.sdk.language": "python"
}

Copy

変更後のメタデータ:

{
  "db.user": "MYUSERNAME",
  "snow.database.id": 13,
  "snow.database.name": "MY_DB",
  "snow.executable.id": 197,
  "snow.executable.name": "UDF_VARCHAR(X VARCHAR):VARCHAR",
  "snow.executable.type": "FUNCTION",
  "snow.owner.id": 2,
  "snow.owner.name": "MY_ROLE",
  "snow.query.id": "01ab0f07-0000-15c8-0000-0129000592c2",
  "snow.schema.id": 16,
  "snow.schema.name": "PUBLIC",
  "snow.session.id": 1275605667850,
  "snow.session.role.primary.id": 2,
  "snow.session.role.primary.name": "MY_ROLE",
  "snow.user.id": 25,
  "snow.warehouse.id": 5,
  "snow.warehouse.name": "MYWH",
  "telemetry.sdk.language": "python"
}

Copy

外部テーブル¶

次の例では、外部テーブルを作成します。

CREATE OR REPLACE EXTERNAL TABLE ext_table(
    data_str VARCHAR AS (value:c1::TEXT))
  LOCATION = @csv_stage
  AUTO_REFRESH = false
  FILE_FORMAT =(type = csv);

GET_DDL 関数の呼び出しから返されるメタデータは以下のように変更されます。

SELECT GET_DDL('table', 'ext_table');

変更前のメタデータ:

create or replace external table EXT_TABLE(
      DATA_STR VARCHAR(16777216) AS (CAST(GET(VALUE, 'c1') AS VARCHAR(16777216))))
location=@CSV_STAGE/
auto_refresh=false
file_format=(TYPE=csv)
;

変更後のメタデータ:

create or replace external table EXT_TABLE(
      DATA_STR VARCHAR(16777216) AS (CAST(GET(VALUE, 'c1') AS VARCHAR)))
location=@CSV_STAGE/
auto_refresh=false
file_format=(TYPE=csv)
;

CREATE TABLE AS SELECT を使用した大型オブジェクト全体のロード¶

VARCHAR、 VARIANT、 OBJECT、 ARRAY の場合は、16 MB よりも大きいオブジェクト（または BINARY、 GEOMETRY、 GEOGRAPHY の場合は8 MB よりも大きいオブジェクト）をロードするために CREATE TABLE AS SELECT ステートメントを使用しようとすると、別のエラーメッセージが表示されます。エラーはソースのタイプによって異なります。このシナリオで INSERT INTO SELECT ステートメントを使用する場合は、同一のメッセージ変更が適用されます。

• JSON ソースからの大型オブジェクト全体のロード

• XML ソースからの大型オブジェクト全体のロード

CREATE OR REPLACE FILE FORMAT json_format TYPE = JSON;

CREATE OR REPLACE TABLE table_varchar (lob_column VARCHAR) AS
  SELECT $1::VARCHAR
    FROM @lob_int_stage/driver_status.json.gz (FILE_FORMAT => 'json_format');

CREATE or REPLACE FILE FORMAT xml_format TYPE = XML;

CREATE OR REPLACE TABLE table_varchar (lob_column VARCHAR) AS
  SELECT $1 AS XML
    FROM @lob_int_stage/large_xml.xte (FILE_FORMAT => 'xml_format');

COPY INTO <テーブル名> ... FROM SELECT を使用した大型オブジェクト全体のロード¶

VARCHAR、 VARIANT、 OBJECT、 ARRAY の場合は、16 MB よりも大きいオブジェクト（または BINARY、 GEOMETRY、 GEOGRAPHY の場合は8 MB よりも大きいオブジェクト）をロードするために COPY INTO <テーブル名> ... FROM SELECT ステートメントを使用しようとすると、別のエラーメッセージが表示されます。エラーはソースのタイプによって異なります。

• JSON ソースからの大型オブジェクト全体のロード

• JSON ソースからのネストされた大型オブジェクトのロード

• XML ソースからの大型オブジェクト全体のロード

CREATE OR REPLACE TABLE table_varchar (lob_column VARCHAR);

COPY INTO table_varchar FROM (
  SELECT $1::VARCHAR
    FROM @lob_int_stage/driver_status.json.gz (FILE_FORMAT => 'json_format'));

CREATE OR REPLACE TABLE table_varchar (lob_column VARCHAR);

COPY INTO table_varchar FROM (
  SELECT $1:"Driver_Status"
    FROM @lob_int_stage/driver_status.json.gz (FILE_FORMAT => 'json_format'));

CREATE OR REPLACE TABLE table_varchar (lob_column VARCHAR);

COPY INTO table_varchar FROM (
  SELECT $1::VARCHAR AS lob_column
    FROM @lob_int_stage/large_xml.xte (FILE_FORMAT => 'xml_format'));

COPY INTO <テーブル名> ... FROM <ステージまたはロケーション> を使用した大型オブジェクト全体のロード¶

VARCHAR、 VARIANT、 OBJECT、 ARRAY の場合は、16 MB よりも大きいオブジェクト（または BINARY、 GEOMETRY、 GEOGRAPHY の場合は8 MB よりも大きいオブジェクト）をロードするために COPY INTO <テーブル名> ... FROM <ステージまたはロケーション> ステートメントを使用しようとすると、別のエラーメッセージが表示されます。エラーはソースのタイプによって異なります。

大きなオブジェクトで COPY コマンドを使用した場合、 ON_ERROR パラメーターを CONTINUE に設定しても、クエリに失敗することがあります。詳細については、 COPY コマンドの使用上の注意 をご参照ください。

• JSON ソースからの大型オブジェクト全体のロード

• XML ソースからの大型オブジェクト全体のロード

CREATE OR REPLACE TABLE table_varchar (lob_column VARCHAR);

COPY INTO table_varchar (lob_column)
  FROM @lob_int_stage/driver_status.json.gz
  FILE_FORMAT = (FORMAT_NAME = json_format);

CREATE OR REPLACE TABLE table_varchar (lob_column VARCHAR);

COPY INTO table_varchar (lob_column)
  FROM @lob_int_stage/large_xml.xte
  FILE_FORMAT = (FORMAT_NAME = xml_format);

JSON ソースからの大型オブジェクト全体のクエリ¶

以下の例では、 JSON ソースから16 MB よりも大きいオブジェクト全体をクエリしようとしています。

SELECT $1
  FROM @lob_int_stage/driver_status.json.gz (FILE_FORMAT => 'json_format');

変更前のエラーメッセージ:

100069 (22P02): Error parsing JSON: document is too large, max size 16777216 bytes

変更後のエラーメッセージ:

100082 (22000): The data length in result column $1 is not supported by this version of the client. Actual length <actual_length> exceeds supported length of 16777216.

XML ソースからの大型オブジェクト全体のクエリ¶

以下の例では、 XML ソースから16 MB よりも大きいオブジェクト全体をクエリしようとしています。

SELECT $1 as lob_column
  FROM @lob_int_stage/large_xml.xte (FILE_FORMAT => 'xml_format');

変更前のエラーメッセージ:

100100 (22P02): Error parsing XML: document is too large, max size 16777216 bytes

変更後のエラーメッセージ:

100082 (22000): The data length in result column $1 is not supported by this version of the client. Actual length <actual_length> exceeds supported length of 16777216.

CSV ソースからの大型オブジェクト全体のクエリ¶

以下の例では、 CSV ソースから16 MB よりも大きいオブジェクト全体をクエリしようとしています。

SELECT $1
  FROM @lob_int_stage/driver_status.csv.gz (FILE_FORMAT => 'csv_format');

変更前のエラーメッセージ:

100082 (22000): Max LOB size (16777216) exceeded, actual size of parsed column is <object_size>

変更後のエラーメッセージ:

100082 (22000): The data length in result column $1 is not supported by this version of the client. Actual length <actual_length> exceeds supported length of 16777216.

Parquetソースからの大型オブジェクト全体のクエリ¶

以下の例では、Parquetソースから16 MB よりも大きいオブジェクト全体をクエリしようとしています。

SELECT $1
  FROM @lob_int_stage/driver_status.parquet (FILE_FORMAT => 'parquet_format');

変更前のエラーメッセージ:

100082 (22000): Max LOB size (16777216) exceeded, actual size of parsed column is <object_size>

変更後のエラーメッセージ:

100082 (22000): The data length in result column $1 is not supported by this version of the client. Actual length <actual_length> exceeds supported length of 16777216.

クエリ結果に 16 MB より大きいオブジェクトを含めようとする¶

次のクエリは、2つの大きな文字列を連結しようとします。

SELECT large_str || large_str FROM lob_strings;

変更前のエラーメッセージ:

100078 (22000): String '<preview_of_string>' is too long and would be truncated in 'CONCAT'

変更後のエラーメッセージ:

100067 (54000): The data length in result column <column_name> is not supported by this version of the client. Actual length <actual_size> exceeds supported length of 16777216.

テーブルに16 MB より大きなオブジェクトを格納しようとする¶

次の CREATE TABLE AS SELECT ステートメントは、2つの大きな文字列を連結しようとします。

CREATE OR REPLACE TABLE table_varchar
  AS SELECT large_str || large_str as LOB_column
  FROM lob_strings;

変更前のエラーメッセージ:

100078 (22000): String '<preview_of_string>' is too long and would be truncated in 'CONCAT'

変更後のエラーメッセージ:

100067 (54000): The data length in result column <column_name> is not supported by this version of the client. Actual length <actual_size> exceeds supported length of 16777216.