| --- |
| layout: global |
| title: Inline Table |
| displayTitle: Inline Table |
| license: | |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --- |
| |
| ### Description |
| |
| An inline table is a temporary table created using a VALUES clause. |
| |
| ### Syntax |
| |
| ```sql |
| VALUES ( expression [ , ... ] ) [ table_alias ] |
| ``` |
| |
| ### Parameters |
| |
| * **expression** |
| |
| Specifies a combination of one or more values, operators and SQL functions that results in a value. |
| |
| * **table_alias** |
| |
| Specifies a temporary name with an optional column name list. |
| |
| **Syntax:** `[ AS ] table_name [ ( column_name [ , ... ] ) ]` |
| |
| ### Examples |
| |
| ```sql |
| -- single row, without a table alias |
| SELECT * FROM VALUES ("one", 1); |
| +----+----+ |
| |col1|col2| |
| +----+----+ |
| | one| 1| |
| +----+----+ |
| |
| -- three rows with a table alias |
| SELECT * FROM VALUES ("one", 1), ("two", 2), ("three", null) AS data(a, b); |
| +-----+----+ |
| | a| b| |
| +-----+----+ |
| | one| 1| |
| | two| 2| |
| |three|null| |
| +-----+----+ |
| |
| -- complex types with a table alias |
| SELECT * FROM VALUES ("one", array(0, 1)), ("two", array(2, 3)) AS data(a, b); |
| +---+------+ |
| | a| b| |
| +---+------+ |
| |one|[0, 1]| |
| |two|[2, 3]| |
| +---+------+ |
| ``` |
| |
| ### Related Statements |
| |
| * [SELECT](sql-ref-syntax-qry-select.html) |