Kategorien:

Funktionen für semistrukturierte und strukturierte Daten (Array/Objekt)

ARRAY_CONSTRUCT

Gibt ein Array zurück, das aus null, einer oder mehreren Eingaben aufgebaut ist.

Weitere Informationen zum Erstellen und Verwenden von Arrays finden Sie unter ARRAY.

Siehe auch:

ARRAY_CONSTRUCT_COMPACT

Syntax

ARRAY_CONSTRUCT( [ <expr1> ] [ , <expr2> [ , ... ] ] )
Copy

Argumente

Die Argumente sind Werte (oder Ausdrücke, die Werte ergeben). Die Argumentwerte können verschiedene Datentypen sein.

Rückgabewerte

Der Datentyp des zurückgegebenen Werts ist ARRAY.

Nutzungshinweise

  • Wenn die Funktion mit N Argumenten aufgerufen wird, beträgt die Größe des resultierenden Arrays N.

  • In vielen Kontexten können Sie anstelle der ARRAY_CONSTRUCT-Funktion auch eine ARRAY-Konstante (ARRAY-Literal genannt) verwenden.

Beispiele

Erstellen eines Basisarrays, das aus numerischen Datentypen besteht:

SELECT ARRAY_CONSTRUCT(10, 20, 30);
Copy
+-----------------------------+
| ARRAY_CONSTRUCT(10, 20, 30) |
|-----------------------------|
| [                           |
|   10,                       |
|   20,                       |
|   30                        |
| ]                           |
+-----------------------------+

Erstellen eines Basisarrays, das aus verschiedenen Datentypen besteht:

SELECT ARRAY_CONSTRUCT(NULL, 'hello', 3::DOUBLE, 4, 5);
Copy
+-------------------------------------------------+
| ARRAY_CONSTRUCT(NULL, 'HELLO', 3::DOUBLE, 4, 5) |
|-------------------------------------------------|
| [                                               |
|   undefined,                                    |
|   "hello",                                      |
|   3.000000000000000e+00,                        |
|   4,                                            |
|   5                                             |
| ]                                               |
+-------------------------------------------------+

Erstellen eines leeren Arrays:

SELECT ARRAY_CONSTRUCT();
Copy
+-------------------+
| ARRAY_CONSTRUCT() |
|-------------------|
| []                |
+-------------------+

Erstellen Sie eine Tabelle und fügen Sie Arrays in eine ARRAY-Spalte ein:

CREATE OR REPLACE TABLE construct_array_example (id INT, array_column ARRAY);

INSERT INTO construct_array_example (id, array_column)
  SELECT 1,
         ARRAY_CONSTRUCT(1, 2, 3);

INSERT INTO construct_array_example (id, array_column)
  SELECT 2,
         ARRAY_CONSTRUCT(4, 5, 6);

INSERT INTO construct_array_example (id, array_column)
  SELECT 3,
         ARRAY_CONSTRUCT(7, 8, 9);

SELECT * FROM construct_array_example;
Copy
+----+--------------+
| ID | ARRAY_COLUMN |
|----+--------------|
|  1 | [            |
|    |   1,         |
|    |   2,         |
|    |   3          |
|    | ]            |
|  2 | [            |
|    |   4,         |
|    |   5,         |
|    |   6          |
|    | ]            |
|  3 | [            |
|    |   7,         |
|    |   8,         |
|    |   9          |
|    | ]            |
+----+--------------+
Sprache: Deutsch