Types de données SQL : modifications de la longueur maximale, de la sortie et des messages d’erreur (en attente)¶

GET_DDL¶

Les métadonnées renvoyées par une fonction GET_DDL change de la manière suivante :

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

Métadonnées avant le changement:

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

Métadonnées après le changement:

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

DESCRIBE FUNCTION¶

Les métadonnées renvoyées pour une instruction DESCRIBE FUNCTION changent de la manière suivante :

DESCRIBE FUNCTION udf_varchar(VARCHAR);

Métadonnées avant le changement:

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

Métadonnées après le changement:

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

Table des événements¶

Pour les nouvelles fonctions définies par l’utilisateur qui renvoient des valeurs VARCHAR ou BINARY en sortie, l’attribut snow.executable.name dans la colonne RESOURCE_ATTRIBUTES de la table d’événements change comme suit :

Métadonnées avant le changement:

{
  "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

Métadonnées après le changement:

{
  "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

Tables externes¶

L’exemple suivant crée une table externe :

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

Les métadonnées renvoyées par une fonction GET_DDL change de la manière suivante :

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

Métadonnées avant le changement:

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)
;

Métadonnées après le changement:

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)
;

Chargement d’un objet entier de grande taille à l’aide de CREATE TABLE AS SELECT¶

Un message d’erreur différent apparaît lorsque vous essayez d’utiliser une instruction CREATE TABLE AS SELECT pour charger des objets plus grands que 16 MB pour VARCHAR, VARIANT, OBJECT et ARRAY (ou plus grand que 8 MB pour BINARY, GEOMETRY ou GEOGRAPHY). L’erreur dépend du type de source. Le même changement de message s’applique lorsqu’une instruction INSERT INTO SELECT est utilisée pour ce scénario.

• Chargement d’un objet entier de grande taille à partir d’une source JSON

• Chargement d’un objet entier de grande taille à partir d’une source 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');

Chargement d’un objet entier de grande taille à l’aide de COPY INTO <nom_table> … FROM SELECT¶

Un message d’erreur différent apparaît lorsque vous essayez d’utiliser une instruction COPY INTO <nom_table> … FROM SELECT pour charger des objets plus grands que 16 MB pour VARCHAR, VARIANT, OBJECT et ARRAY (ou plus grand que 8 MB pour BINARY, GEOMETRY ou GEOGRAPHY). L’erreur dépend du type de source.

• Chargement d’un objet entier de grande taille à partir d’une source JSON

• Chargement de grands objets imbriqués à partir d’une source JSON

• Chargement d’un objet entier de grande taille à partir d’une source 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'));

Chargement d’un objet entier de grande taille à l’aide de COPY INTO <nom_table> … FROM <zone_de_preparation_ou_emplacement>¶

Un message d’erreur différent apparaît lorsque vous essayez d’utiliser une instruction COPY INTO <nom_table> … FROM <zone_de_preparation_ou_emplacement> pour charger des objets plus grands que 16 MB pour VARCHAR, VARIANT, OBJECT et ARRAY (ou plus grand que 8 MB pour BINARY, GEOMETRY ou GEOGRAPHY). L’erreur dépend du type de source.

Si vous utilisez la commande COPY avec des objets volumineux, les requêtes peuvent échouer même lorsque le paramètre ON_ERROR est défini sur CONTINUE. Pour plus d’informations, voir les notes sur l’utilisation de la commande COPY.

• Chargement d’un objet entier de grande taille à partir d’une source JSON

• Chargement d’un objet entier de grande taille à partir d’une source 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);

Interrogation d’un objet entier de grande taille à partir d’une source JSON¶

L’exemple suivant tente d’interroger un objet entier supérieur à 16 MB d’une source JSON :

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

Message d’erreur avant le changement:

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

Message d’erreur après le changement:

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.

Interrogation d’un objet entier de grande taille à partir d’une source XML¶

L’exemple suivant tente d’interroger un objet entier supérieur à 16 MB d’une source XML :

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

Message d’erreur avant le changement:

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

Message d’erreur après le changement:

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.

Interrogation d’un objet entier de grande taille à partir d’une source CSV¶

L’exemple suivant tente d’interroger un objet entier supérieur à 16 MB d’une source CSV :

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

Message d’erreur avant le changement:

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

Message d’erreur après le changement:

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.

Interrogation d’un objet entier de grande taille à partir d’une source Parquet¶

L’exemple suivant tente d’interroger un objet entier supérieur à 16 MB d’une source Parquet :

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

Message d’erreur avant le changement:

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

Message d’erreur après le changement:

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.

Tentative d’inclusion d’un objet de plus de 16 MB dans les résultats de la requête¶

La requête suivante tente de concaténer deux grandes chaînes :

SELECT large_str || large_str FROM lob_strings;

Message d’erreur avant le changement:

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

Message d’erreur après le changement:

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.

Tentative de stockage d’un objet supérieur à 16 MB dans une table¶

L’instruction CREATE TABLE AS SELECT suivante tente de concaténer deux grandes chaînes :

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

Message d’erreur avant le changement:

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

Message d’erreur après le changement:

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.