ARRAY_WITH_CONSTANT

ファンクション

ARRAY_WITH_CONSTANTは、指定された長さの配列を生成するために使用され、すべての要素が与えられた値を持ちます。

Syntax

ARRAY_WITH_CONSTANT(count, element)

パラメータ

• count: Integer型、返される配列の長さを指定します。

• element: ARRAYでサポートされる任意のストレージ型。

戻り値

• ARRAY<T>型の配列を返します。ここでTはelementの型です。
  • 配列には同じelementのcount個のコピーが含まれます。

使用上の注意

• count = 0またはNULLの場合、空の配列を返します。
• elementがNULLの場合、配列内のすべての要素がNULLになります。
• この関数はARRAY_REPEATと同じ機能を持ちますが、パラメータの順序が逆になっています。
• 他の配列関数と組み合わせて、より複雑なデータを構築できます。

例

1. 簡単な例

   SELECT ARRAY_WITH_CONSTANT(3, 'hello');
   +---------------------------------+
   | ARRAY_WITH_CONSTANT(3, 'hello') |
   +---------------------------------+
   | ["hello", "hello", "hello"]     |
   +---------------------------------+

2. 特殊なケース

   SELECT ARRAY_WITH_CONSTANT(0, 'hello');
   +---------------------------------+
   | ARRAY_WITH_CONSTANT(0, 'hello') |
   +---------------------------------+
   | []                              |
   +---------------------------------+
   
   SELECT ARRAY_WITH_CONSTANT(NULL, 'hello');
   +------------------------------------+
   | ARRAY_WITH_CONSTANT(NULL, 'hello') |
   +------------------------------------+
   | []                                 |
   +------------------------------------+
   
   SELECT ARRAY_WITH_CONSTANT(2, NULL);
   +------------------------------+
   | ARRAY_WITH_CONSTANT(2, NULL) |
   +------------------------------+
   | [null, null]                 |
   +------------------------------+
   
   SELECT ARRAY_WITH_CONSTANT(NULL, NULL);
   +---------------------------------+
   | ARRAY_WITH_CONSTANT(NULL, NULL) |
   +---------------------------------+
   | []                              |
   +---------------------------------+
   
   -- Returns error: INVALID_ARGUMENT
   SELECT ARRAY_WITH_CONSTANT(-1, 'hello');