AS_ARRAY¶

Syntax¶

AS_ARRAY( <variant_expr> )

Argumente¶

variant_expr

Ein Ausdruck, der einen Wert vom Typ VARIANT ergibt.

Rückgabewerte¶

Die Funktion gibt einen Wert vom Typ ARRAY oder NULL zurück.

• Wenn der Typ des Werts im Argument variant_expr ARRAY ist, gibt die Funktion einen Wert vom Typ ARRAY zurück.

• Wenn der Typ des Werts im Argument variant_expr nicht mit dem Typ des Ausgabewerts übereinstimmt, gibt die Funktion NULL zurück.

• Wenn das Argument variant_expr NULL ist, gibt die Funktion NULL zurück.

Nutzungshinweise¶

• Diese Funktion unterstützt keine strukturierten Typen als Eingabeargument.

Beispiele¶

Erstellen Sie eine Tabelle, und laden Sie Daten hinein:

CREATE OR REPLACE TABLE as_array_example (
  array1 VARIANT,
  array2 VARIANT);

INSERT INTO as_array_example (array1, array2)
  SELECT
    TO_VARIANT(TO_ARRAY('Example')),
    TO_VARIANT(ARRAY_CONSTRUCT('Array-like', 'example'));

Verwenden Sie die Funktion AS_ARRAY in einer Abfrage, um einen VARIANT-Wert in ARRAY-Werte umzuwandeln:

SELECT AS_ARRAY(array1) AS array1,
       AS_ARRAY(array2) AS array2
  FROM as_array_example;

+-------------+-----------------+
| ARRAY1      | ARRAY2          |
|-------------+-----------------|
| [           | [               |
|   "Example" |   "Array-like", |
| ]           |   "example"     |
|             | ]               |
+-------------+-----------------+