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를 사용하여 대규모 오브젝트 전체를 로드하기¶

CREATE TABLE AS SELECT 문을 사용하여 VARCHAR, VARIANT, OBJECT 및 ARRAY의 경우 16MB를 초과하는(BINARY, GEOMETRY 또는 GEOGRAPHY의 경우 8MB 초과) 오브젝트를 로드하려고 하면 다른 오류 메시지가 표시됩니다. 오류는 소스의 유형에 따라 달라집니다. 이 시나리오에 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 <table_name> … FROM SELECT를 사용하여 대규모 오브젝트 전체를 로드하기¶

COPY INTO <table_name> … FROM SELECT 문을 사용하여 VARCHAR, VARIANT, OBJECT 및 ARRAY의 경우 16MB를 초과하는(BINARY, GEOMETRY 또는 GEOGRAPHY의 경우 8MB 초과) 오브젝트를 로드하려고 하면 다른 오류 메시지가 표시됩니다. 오류는 소스의 유형에 따라 달라집니다.

• 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 <table_name> … FROM <stage_or_location> 를 사용하여 대규모 오브젝트 전체를 로드하기¶

COPY INTO <table_name> … FROM <stage_or_location> 문을 사용하여 VARCHAR, VARIANT, OBJECT 및 ARRAY의 경우 16MB를 초과하는(BINARY, GEOMETRY 또는 GEOGRAPHY의 경우 8MB 초과) 오브젝트를 로드하려고 하면 다른 오류 메시지가 표시됩니다. 오류는 소스의 유형에 따라 달라집니다.

대규모 오브젝트와 함께 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 소스에서 16MB를 초과하는 전체 오브젝트를 쿼리합니다.

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 소스에서 16MB를 초과하는 전체 오브젝트를 쿼리합니다.

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 소스에서 16MB를 초과하는 전체 오브젝트를 쿼리합니다.

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 소스에서 16MB를 초과하는 전체 오브젝트를 쿼리합니다.

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.

쿼리 결과에 16MB를 초과하는 오브젝트를 포함하려고 시도하는 경우¶

다음 쿼리는 두 개의 대규모 문자열을 연결하려고 시도합니다.

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.

테이블에 16MB를 초과하는 오브젝트를 저장하려고 시도하는 경우¶

다음 CREATE TABLE AS SELECT 문은 두 개의 대규모 문자열을 연결하려고 시도합니다.

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.