---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/concepts/datamodel/external_data_source.md?version=main
  - https://ydb.tech/docs/ru/concepts/datamodel/external_data_source.md?version=main
sourcePath: ru/core/concepts/datamodel/external_data_source.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Внешние источники данных

Внешний источник (external data source) - это объект в YDB, описывающий параметры подключения к внешнему источнику данных. Например, в случае ClickHouse внешний источник описывает сетевой адрес, логин и пароль для аутентификации в кластере ClickHouse, а в случае S3 (Object Storage) описывает реквизиты доступа и путь к бакету.

В следующем примере приведен пример создания внешнего источника, ведущего на кластер ClickHouse:

```yql
CREATE EXTERNAL DATA SOURCE test_data_source WITH (
  SOURCE_TYPE="ClickHouse",
  LOCATION="192.168.1.1:8123",
  DATABASE_NAME="default",
  AUTH_METHOD="BASIC",
  USE_TLS="TRUE",
  LOGIN="login",
  PASSWORD_SECRET_PATH="test_password_path",
  PROTOCOL="NATIVE"
);
```

После создания внешнего источника данных можно выполнять чтение данных из созданного объекта `EXTERNAL DATA SOURCE`. Пример ниже иллюстрирует чтение данных из таблицы `test_table` из базы данных `default` в кластере ClickHouse:

```yql
SELECT * FROM test_data_source.test_table;
```

С помощью внешних источников данных можно выполнять [федеративные запросы](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/index.md?version=main) для задач межсистемной аналитики данных.

В качестве источников данных можно использовать:

<!-- source: ru/concepts/query_execution/federated_query/_includes/supported_eds.md -->
- [S3](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/s3/external_table.md?version=main)
<!-- endsource: ru/concepts/query_execution/federated_query/_includes/supported_eds.md -->

{% cut "Экспериментальные источники данных" %}

<!-- source: ru/concepts/query_execution/federated_query/_includes/experimental_eds.md -->
- [ClickHouse](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/clickhouse.md?version=main)
- [Greenplum](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/greenplum.md?version=main)
- [Microsoft SQL Server](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/ms_sql_server.md?version=main)
- [MySQL](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/mysql.md?version=main)
- [PostgreSQL](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/postgresql.md?version=main)
- [YDB](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/ydb.md?version=main) (федеративные запросы между базами YDB)
<!-- endsource: ru/concepts/query_execution/federated_query/_includes/experimental_eds.md -->

{% endcut %}