> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> `remote_servers` セクションで設定されたクラスターのすべての分片に、Distributed テーブルを作成せずにアクセスできます。

# clusterAllReplicas

Distributed テーブルを作成せずに、クラスターのすべての分片 (`remote_servers` セクションで設定) にアクセスできます。各分片では、1 つのレプリカのみがクエリされます。

`clusterAllReplicas` 関数 — `cluster` と同様ですが、すべてのレプリカがクエリされます。クラスター内の各レプリカは、それぞれ個別の分片/接続として扱われます。

<Note>
  使用可能なすべてのクラスターは、[system.clusters](/ja/reference/system-tables/clusters) テーブルに一覧表示されます。また、[Distributed](/ja/reference/engines/table-engines/special/distributed) テーブルについては該当ページを参照してください。
</Note>

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

```sql theme={null}
cluster(['cluster_name', db.table, sharding_key][, SETTINGS name = value, ...])
cluster(['cluster_name', db, table, sharding_key][, SETTINGS name = value, ...])
clusterAllReplicas(['cluster_name', db.table, sharding_key][, SETTINGS name = value, ...])
clusterAllReplicas(['cluster_name', db, table, sharding_key][, SETTINGS name = value, ...])
```

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

| 引数                           | 型                                                                                              |
| ---------------------------- | ---------------------------------------------------------------------------------------------- |
| `cluster_name`               | リモートおよびローカルのサーバーに対するアドレスのセットと接続パラメーターの構築に使用されるクラスター名です。指定しない場合は `default` が設定されます。             |
| `db.table` or `db`, `table`  | データベース名とテーブル名です。                                                                               |
| `sharding_key`               | シャーディングキーです。省略可能です。クラスターに複数の分片がある場合は指定する必要があります。                                               |
| `SETTINGS name = value, ...` | 関数によって作成されるDistributedテーブルの設定です (例: `skip_unavailable_shards`) 。省略可能です。クエリで指定された設定がこれより優先されます。 |

<div id="returned-value">
  ## 戻り値
</div>

クラスターから取得したデータセット。

<div id="using-macros">
  ## マクロの使用
</div>

`cluster_name` には、`{}` で置換されるマクロを含めることができます。置換される値は、サーバー設定ファイルの [macros](/ja/reference/settings/server-settings/settings/other#macros) セクションから取得されます。

例:

```sql theme={null}
SELECT * FROM cluster('{cluster}', default.example_table);
```

<div id="usage_recommendations">
  ## 使用方法と推奨事項
</div>

`cluster` および `clusterAllReplicas` テーブル関数の使用は、`Distributed` テーブルを作成する場合よりも非効率です。これは、この場合、リクエストごとにサーバー接続が再確立されるためです。大量のクエリを処理する場合は、必ずあらかじめ `Distributed` テーブルを作成し、`cluster` および `clusterAllReplicas` テーブル関数は使用しないでください。

`cluster` および `clusterAllReplicas` テーブル関数は、次のような場合に役立ちます。

* データの比較、デバッグ、テストのために特定のクラスターにアクセスする場合。
* 調査目的で、さまざまな ClickHouse クラスターやレプリカに対してクエリを実行する場合。
* 手動で実行する頻度の低い分散リクエスト。

`host`、`port`、`user`、`password`、`compression`、`secure` などの接続設定は、`<remote_servers>` 設定セクションから取得されます。詳細は [Distributed engine](/ja/reference/engines/table-engines/special/distributed) を参照してください。

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

* [skip\_unavailable\_shards](/ja/reference/settings/session-settings/skip-unavailable-shards#skip_unavailable_shards)
* [load\_balancing](/ja/reference/settings/session-settings/load-balancing#load_balancing)