---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.4
alternate:
  - https://ydb.tech/docs/en/concepts/query_execution/federated_query/import_and_export.md
  - https://ydb.tech/docs/ru/concepts/query_execution/federated_query/import_and_export.md
sourcePath: ru/core/concepts/query_execution/federated_query/import_and_export.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Импорт и экспорт данных с использованием федеративных запросов

{% note info %}

При импорте/экспорте данных из/в S3 в формате Parquet необходимо учитывать [маппинг типов YQL и Apache Arrow](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/s3/arrow_types_mapping.md).

{% endnote %}

## Импорт данных {#import}

Федеративные запросы позволяют импортировать данные из подключенных внешних источников в таблицы базы данных YDB. Для импорта данных нужно использовать запрос чтения из [внешнего источника данных](https://ydb.tech/docs/ru/concepts/datamodel/external_data_source.md) или [внешней таблицы](https://ydb.tech/docs/ru/concepts/datamodel/external_table.md) и записи в YDB таблицу.

Для колоночных таблиц поддерживается массивно-параллельный импорт из внешнего источника при использовании конструкций UPSERT и INSERT — несколько рабочих потоков параллельно читают данные из внешнего источника и пишут в таблицу. Для строковых таблиц функциональность в разработке.

|Операция|Запись в [строковые таблицы](../../datamodel/table.md#row-oriented-tables)|Запись в [колоночные таблицы](../../datamodel/table.md#column-oriented-tables)|
|--------|-----------------|------------------|
|[UPSERT](../../../yql/reference/syntax/upsert_into.md)|однопоточная|параллельная|
|[REPLACE](../../../yql/reference/syntax/replace_into.md)|однопоточная|параллельная|
|[INSERT](../../../yql/reference/syntax/insert_into.md)|однопоточная|параллельная|

{% note tip %}

Рекомендованными вариантами импорта с использованием федеративных запросов являются операции `UPSERT` и `REPLACE` — для них значительно оптимизирован сценарий импорта данных.

{% endnote %}

Пример импорта данных из PostgreSQL таблицы в YDB таблицу:

```yql
UPSERT INTO target_table
SELECT * FROM postgresql_datasource.source_table
```

Подробнее про создание внешних источников данных и внешних таблиц, а также про запросы чтения данных из них можно прочитать в статьях:

- [ClickHouse](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/clickhouse.md#query)
- [Greenplum](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/greenplum.md#query)
- [Microsoft SQL Server](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/ms_sql_server.md#query)
- [MySQL](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/mysql.md#query)
- [PostgreSQL](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/postgresql.md#query)
- [S3](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/s3/external_table.md)
- [YDB](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/ydb.md#query)

## Экспорт данных {#export}

На данный момент экспорт данных с использованием федеративных запросов поддержан только для S3-совместимых хранилищ, подробнее смотреть в статье [Экспорт данных в объектное хранилище S3](https://ydb.tech/docs/ru/concepts/query_execution/federated_query/s3/write_data.md#export-to-s3).