Skip to content

Commit a6cd079

Browse files
authored
YDB FQ: drop 'Preview' warning in FQ docs (#9188)
1 parent dde850f commit a6cd079

File tree

8 files changed

+15
-40
lines changed

8 files changed

+15
-40
lines changed

ydb/docs/en/core/concepts/datamodel/external_data_source.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,5 @@
11
# External data sources
22

3-
{% note warning %}
4-
5-
This functionality is in "Experimental" mode.
6-
7-
{% endnote %}
83

94
An external data source is an object in {{ ydb-full-name }} that describes the connection parameters to an external data source. For example, in the case of ClickHouse, the external data source describes the network address, login, and password for authentication in the ClickHouse cluster. In the case of S3 ({{ objstorage-name }}), it describes the access credentials and the path to the bucket.
105

@@ -35,4 +30,4 @@ The following data sources can be used:
3530

3631
- [ClickHouse](../federated_query/clickhouse.md)
3732
- [PostgreSQL](../federated_query/postgresql.md)
38-
- [Connections to S3 ({{ objstorage-name }})](../federated_query/s3/external_data_source.md)
33+
- [Connections to S3 ({{ objstorage-name }})](../federated_query/s3/external_data_source.md)

ydb/docs/en/core/concepts/datamodel/external_table.md

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,5 @@
11
# External tables
22

3-
{% note warning %}
4-
5-
This functionality is in "Preview" mode.
6-
7-
{% endnote %}
8-
93
Some [external data sources](external_data_source.md), such as database management systems, store data in a structured format, while others, like S3 ({{objstorage-full-name}}), store data as individual files. To work with file-based data sources, you need to understand both the file placement rules and the formats of the stored data.
104

115
A special entity, `EXTERNAL TABLE,` describes the stored data in such sources. External tables allow you to define the schema of the stored files and the schema of file placement within the source.
@@ -31,4 +25,4 @@ INSERT INTO s3_test_data
3125
SELECT * FROM Table
3226
```
3327

34-
More details on working with external tables describing S3 buckets ({{ objstorage-name }}) can be found in section [{#T}](../federated_query/s3/external_table.md).
28+
More details on working with external tables describing S3 buckets ({{ objstorage-name }}) can be found in section [{#T}](../federated_query/s3/external_table.md).

ydb/docs/en/core/concepts/datamodel/secrets.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,11 @@
11
# Secrets
22

3+
{% note warning %}
4+
5+
This functionality is in "Preview" mode.
6+
7+
{% endnote %}
8+
39
To work with external data sources in {{ ydb-full-name }}, [federated queries](../federated_query/index.md) are used. Federated queries utilize various access credentials for authentication in external systems. These credentials are stored in separate objects called secrets. Secrets are only available for writing and updating; their values cannot be retrieved.
410

511
{% note warning %}
@@ -24,4 +30,4 @@ Special objects called `SECRET_ACCESS` are used to manage access to secrets. To
2430

2531
```yql
2632
CREATE OBJECT `MySecretName:another_user` (TYPE SECRET_ACCESS)
27-
```
33+
```

ydb/docs/en/core/concepts/federated_query/index.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,5 @@
11
# Federated queries
22

3-
{% note warning %}
4-
5-
This functionality is in "Preview" mode.
6-
7-
{% endnote %}
8-
93
Federated queries allow retrieving information from various data sources without needing to transfer the data from these sources into {{ ydb-full-name }} storage. Currently, federated queries support interaction with ClickHouse, PostgreSQL, and S3-compatible data stores. Using YQL queries, you can access these databases without the need to duplicate data between systems.
104

115
To work with data stored in external DBMSs, it is sufficient to create an [external data source](../datamodel/external_data_source.md). To work with unstructured data stored in S3 buckets, you additionally need to create an [external table](../datamodel/external_table.md). In both cases, it is necessary to create [secrets](../datamodel/secrets.md) objects first that store confidential data required for authentication in external systems.

ydb/docs/ru/core/concepts/datamodel/external_data_source.md

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,5 @@
11
# Внешние источники данных
22

3-
{% note warning %}
4-
5-
Данная функциональность находится в режиме "Experimental".
6-
7-
{% endnote %}
8-
9-
103
Внешний источник (external data source) - это объект в {{ ydb-full-name }}, описывающий параметры подключения к внешнему источнику данных. Например, в случае ClickHouse внешний источник описывает сетевой адрес, логин и пароль для аутентификации в кластере ClickHouse, а в случае S3 ({{ objstorage-name }}) описывает реквизиты доступа и путь к бакету.
114

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

ydb/docs/ru/core/concepts/datamodel/external_table.md

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,5 @@
11
# Внешние таблицы
22

3-
{% note warning %}
4-
5-
Данная функциональность находится в режиме "Preview".
6-
7-
{% endnote %}
8-
9-
103
Часть [внешних источников](external_data_source.md), например, системы управления базами данных, хранят данные в схематизированном виде, а часть, как S3 ({{objstorage-full-name}}), в виде отдельных файлов. Для работы с файловыми источниками данных необходимо знать как правила расположения файлов, так и форматы самих хранимых данных.
114

125
Для описания хранимых данных в таких источниках используется специальная сущность - внешние таблицы, `EXTERNAL TABLE`. Внешние таблицы позволяют задать схему данных у хранимых файлов, а также описать схему расположения файлов внутри источника.

ydb/docs/ru/core/concepts/datamodel/secrets.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,11 @@
11
# Секреты
22

3+
{% note warning %}
4+
5+
Данная функциональность находится в режиме "Preview".
6+
7+
{% endnote %}
8+
39
Для работы с внешними источниками данных в {{ ydb-full-name }} используются [федеративные запросы](../federated_query/index.md). Для аутентификации во внешних системах федеративные запросы используют различные реквизиты доступа. Реквизиты доступа хранятся в отдельных объектах - секретах. Секреты доступны только для записи и обновления, получить значение секрета нельзя.
410

511
{% note warning %}

ydb/docs/ru/core/concepts/federated_query/index.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,5 @@
11
# Федеративные запросы
22

3-
{% note warning %}
4-
5-
Данная функциональность находится в режиме "Preview".
6-
7-
{% endnote %}
8-
93
Федеративные запросы - это способ получать информацию из различных источников данных без необходимости переноса данных этих источников внутрь {{ ydb-full-name }}. В настоящее время федеративные запросы поддерживают взаимодействие с базами данных ClickHouse, PostgreSQL и с хранилищами данных класса S3. При помощи YQL запросов вы сможете обращаться к этим базам данных без необходимости дублирования данных между системами.
104

115
Для работы с данными, хранящимися во внешних СУБД, достаточно создать [внешний источник данных](../datamodel/external_data_source.md). Для работы с несхематизированными данными, хранящимися в бакетах S3 нужно дополнительно создать [внешнюю таблицу](../datamodel/external_table.md). В обоих случаях необходимо предварительно создать объекты-[секреты](../datamodel/secrets.md), хранящие конфиденциальные данные, необходимые для аутентификации во внешних системах.

0 commit comments

Comments
 (0)