> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> SQLite データベースに格納されているデータに対してクエリを実行できます。

# sqlite

[SQLite](/docs/ja/reference/engines/database-engines/sqlite) データベースに格納されているデータに対してクエリを実行できます。

<div id="syntax">
  ## 構文
</div>

```sql theme={null}
sqlite('db_path', 'table_name')
```

<div id="arguments">
  ## 引数
</div>

* `db_path` — SQLite データベースを含むファイルへのパス。[String](/docs/ja/reference/data-types/string)。
* `table_name` — SQLite データベース内のテーブル名、または SQLite にそのまま渡されるクエリ ([テーブル名の代わりにクエリを渡す](#passing-a-query) を参照) 。[String](/docs/ja/reference/data-types/string)。

<div id="returned_value">
  ## 戻り値
</div>

* 元の`SQLite`テーブルと同じカラムを持つテーブルオブジェクト。

<div id="passing-a-query">
  ## テーブル名の代わりにクエリを渡す
</div>

第2引数には、テーブル名の代わりに、そのまま SQLite に渡される `SELECT` クエリを指定できます。生成されるテーブルの構造は、クエリ結果から推論されます。クエリは、サブクエリとして記述することも、`query` 関数で囲むこともできます。

```sql theme={null}
SELECT * FROM sqlite('sqlite.db', (SELECT col1, col2 FROM table1 WHERE col2 > 1));
SELECT * FROM sqlite('sqlite.db', query('SELECT col1, col2 FROM table1 WHERE col2 > 1'));
```

このようなテーブルは読み取り専用で、`INSERT` はできません。同じ構文は [`SQLite`](/docs/ja/reference/engines/table-engines/integrations/sqlite) テーブルエンジンでもサポートされています。

<Note>
  サブクエリ形式 `(SELECT ...)` は ClickHouse で解析され、SQLite に送信される前に再シリアル化されます。そのため、有効な ClickHouse SQL である必要があります。ClickHouse が解析しない SQLite 固有の構文を渡すには、`query('...')` 形式を使用してください。この形式では、テキストがそのまま SQLite に送信されます。

  また、渡されたクエリには、外側の ClickHouse クエリの `WHERE`、`LIMIT`、aggregation などは **プッシュダウンされず**、クエリ結果全体を取得した後に ClickHouse 側で適用されます。SQLite から読み取るデータを制限するには、渡すクエリ内に filter を記述してください。[`external_table_strict_query = 1`](/docs/ja/reference/settings/session-settings#external_table_strict_query) を指定すると、プッシュダウンできない外側の filter はローカルで適用されず、代わりに例外として拒否されます。
</Note>

<div id="example">
  ## 例
</div>

```sql title="Query" theme={null}
SELECT * FROM sqlite('sqlite.db', 'table1') ORDER BY col2;
```

```text title="Response" theme={null}
┌─col1──┬─col2─┐
│ line1 │    1 │
│ line2 │    2 │
│ line3 │    3 │
└───────┴──────┘
```

<div id="related">
  ## 関連
</div>

* [SQLite](/docs/ja/reference/engines/table-engines/integrations/sqlite) テーブルエンジン
* [SQLite database engine](/docs/ja/reference/engines/database-engines/sqlite) — データ型サポートのセクション