[docs] Removed TOC links to PostgreSQL compatibility articles (#30280)

asmyasnikov · Stepan Beloyarov · SixOnMyface · ydbot · commit a71889cb48c6 · 2026-04-13T19:25:41.000Z
Co-authored-by: Stepan Beloyarov &lt;beloyarovstep@yandex-team.ru&gt;
Co-authored-by: SixOnMyface &lt;103491956+SixOnMyface@users.noreply.github.com&gt;
diff --git a/ydb/docs/en/core/changelog-cli.md b/ydb/docs/en/core/changelog-cli.md
@@ -422,15 +422,15 @@ Released on January 12, 2024. To update to version **2.8.0**, select the [Downlo
 
 * Fixed an error displaying tables in `pretty` format with [Unicode](https://en.wikipedia.org/wiki/Unicode) characters.
 
-* Fixed an error substituting the wrong primary key in the command [ydb tools pg-convert](postgresql/import.md#pg-convert).
+* Fixed an error substituting the wrong primary key in the command [ydb tools pg-convert](./postgresql/import.md#pg-convert).
 
 ## Version 2.7.0 {#2-7-0}
 
 Released on October 23, 2023. To update to version **2.7.0**, select the [Downloads](downloads/ydb-cli.md) section.
 
 ### Features
 
-* Added the [ydb tools pg-convert](postgresql/import.md#pg-convert) command, which prepares a dump obtained by the [pg_dump](https://www.postgresql.org/docs/current/app-pgdump.html) utility for loading into the YDB postgres-compatible layer.
+* Added the [ydb tools pg-convert](./postgresql/import.md#pg-convert) command, which prepares a dump obtained by the [pg_dump](https://www.postgresql.org/docs/current/app-pgdump.html) utility for loading into the YDB postgres-compatible layer.
 * Added the `{{ ydb-cli }} workload query` load testing command, which loads the database with [script execution queries](reference/ydb-cli/yql.md) in multiple threads.
 * Added new `{{ ydb-cli }} scheme permissions list` command to list permissions.
 * In the commands [ydb table query execute](reference/ydb-cli/table-query-execute.md), [ydb table query explain](reference/ydb-cli/commands/explain-plan.md), [ydb yql](reference/ydb-cli/yql.md), and [ydb scripting yql](reference/ydb-cli/scripting-yql.md), the `--flame-graph` option has been added, specifying the path to the file in which you need to save the visualization of query execution statistics.
diff --git a/ydb/docs/en/core/dev/getting-started.md b/ydb/docs/en/core/dev/getting-started.md
@@ -11,7 +11,6 @@ In parallel with designing the schema, you need to set up your development envir
 Choose the {{ ydb-short-name }} API you want to use; there are several options:
 
 - The recommended way for mainstream programming languages is using a [{{ ydb-short-name }} SDK](../reference/ydb-sdk/index.md). They provide high-level APIs and implement best practices on working with {{ ydb-short-name }}. {{ ydb-short-name }} SDKs are available for several popular languages and strive for feature parity, but not all are feature-complete. Refer to the [SDK feature comparison table](../reference/ydb-sdk/feature-parity.md) to check if the SDK for the programming language you had in mind will fit your needs or to choose a programming language with better feature coverage if you're flexible.
-- Alternatively, {{ ydb-short-name }} provides [PostgreSQL-compatible API](../postgresql/intro.md). It is intended to simplify migrating existing applications that have outgrown PostgreSQL. However, it is also useful for exotic programming languages that have a PostgreSQL client library but don't have a {{ ydb-short-name }} SDK. Refer to PostgreSQL compatibility documentation to check if its completeness will suit your needs.
 - If you are interested in [{{ ydb-short-name }} topics](../concepts/datamodel/topic.md) feature, it is worth noting that they also provide [Kafka-compatible API](../reference/kafka-api/index.md). Follow that link if this use case is relevant.
 - As a last resort, {{ ydb-short-name }}'s native API is based on the [gRPC](https://grpc.io/) protocol, which has an ecosystem around it, including code generation of clients. [{{ ydb-short-name}}'s gRPC specs are hosted on GitHub](https://github.com/ydb-platform/ydb/tree/main/ydb/public/api/grpc) and you could leverage them in your application. The generated clients are low-level and will require extra work to handle aspects like retries and timeouts properly, so go this route only if other options above aren't possible and you know what you're doing.
 
@@ -36,11 +35,6 @@ Additionally, you'd want to set up at least one of the available ways to run ad-
 - Learn how to [handle {{ ydb-short-name }} SDK errors](../reference/ydb-sdk/error_handling.md).
 - Leverage your IDE capabilities to navigate the SDK code.
 
-### For PostgreSQL-compatibility route
-
-- Learn how to [connect PostgreSQL driver with {{ ydb-short-name }} cluster](../postgresql/docker-connect.md).
-- The rest should be similar to using vanilla PostgreSQL. Use your experience with it or refer to any favorite resources. However, refer to the list of [functions](../postgresql/functions.md) and statements to adjust your expectations.
-
 ## Testing
 
 To write tests on applications working with {{ ydb-short-name }}:
diff --git a/ydb/docs/en/core/dev/index.md b/ydb/docs/en/core/dev/index.md
@@ -24,7 +24,6 @@ Main resources:
   - [{#T}](../yql/reference/index.md)
   - [{#T}](../reference/ydb-sdk/index.md)
   - [{#T}](../reference/ydb-cli/index.md)
-  - [{#T}](../postgresql/intro.md)
   - [{#T}](../reference/kafka-api/index.md)
 
 If you're interested in developing {{ ydb-short-name }} core or satellite projects, refer to the [documentation for contributors](../contributor/index.md).
diff --git a/ydb/docs/en/core/index.yaml b/ydb/docs/en/core/index.yaml
@@ -34,9 +34,6 @@ links:
   - title: Working with the SDK
     description: YDB SDK reference
     href: reference/ydb-sdk/
-  - title: PostgreSQL compatibility
-    description: Integrate with PostgreSQL ecosystem
-    href: postgresql/intro/
   - title: Troubleshooting
     description: Troubleshooting issues related to YDB databases and applications
     href: troubleshooting/
diff --git a/ydb/docs/en/core/integrations/index.md b/ydb/docs/en/core/integrations/index.md
@@ -4,7 +4,7 @@ This section provides the main information about {{ ydb-name }} integrations wit
 
 {% note info %}
 
-In addition to its own native protocol, {{ ydb-name }} has a compatibility layer that allows external systems to connect to databases via network protocols PostgreSQL or Apache Kafka. Due to the compatibility layer, many tools designed to work with these systems can also interact with {{ ydb-name }}. The compatibility level of each specific application needs to be clarified separately.
+In addition to its own native protocol, {{ ydb-name }} has a compatibility layer that allows external systems to connect to databases via network protocols [PostgreSQL](../postgresql/intro.md) or [Apache Kafka](../reference/kafka-api/index.md). Due to the compatibility layer, many tools designed to work with these systems can also interact with {{ ydb-name }}. The compatibility level of each specific application needs to be clarified separately.
 
 {% endnote %}
 
@@ -44,5 +44,4 @@ In addition to its own native protocol, {{ ydb-name }} has a compatibility layer
 ## See also
 
 * [{#T}](../reference/ydb-sdk/index.md)
-* [{#T}](../postgresql/intro.md)
 * [{#T}](../reference/kafka-api/index.md)
diff --git a/ydb/docs/en/core/integrations/visualization/finebi.md b/ydb/docs/en/core/integrations/visualization/finebi.md
@@ -4,7 +4,11 @@ FineBI is a powerful big data analytics tool. FineBI allows organizations to ana
 
 [PostgreSQL compatibility mode in {{ ydb-short-name }}](../../postgresql/intro.md) enables the use of [FineBI](https://intl.finebi.com/) to query and visualize data from {{ ydb-short-name }}. In this case FineBI works with {{ ydb-short-name }} just like with PostgreSQL.
 
-{% include [../../postgresql/_includes/alert_preview.md](../../postgresql/_includes/alert_preview.md) %}
+{% note warning %}
+
+At the moment, {{ ydb-short-name }}'s compatibility with PostgreSQL **is under development**, so not all PostgreSQL constructs and [functions](../../postgresql/functions.md) are supported yet. PostgreSQL compatibility is available for testing in the form of a Docker container, which can be deployed by following these [instructions](../../postgresql/docker-connect.md).
+
+{% endnote %}
 
 ## Prerequisites
 
diff --git a/ydb/docs/en/core/postgresql/toc_i.yaml b/ydb/docs/en/core/postgresql/toc_i.yaml
@@ -1,4 +1,6 @@
 items:
+- name: Overview
+  href: intro.md
 - name: Connection via PostgreSQL protocol
   href: docker-connect.md
 - name: PostgreSQL statements
diff --git a/ydb/docs/en/core/reference/configuration/tls.md b/ydb/docs/en/core/reference/configuration/tls.md
@@ -32,17 +32,6 @@ grpc_config:
    ca: "/opt/ydb/certs/ca.crt"
 ```
 
-### PostgreSQL Wire Protocol
-
-{{ ydb-short-name }} exposes a separate network port for the [PostgreSQL wire protocol](../../postgresql/intro.md). This protocol is used for external communication with client applications initially designed to work with [PostgreSQL](https://www.postgresql.org/).
-
-Example of enabling TLS for the PostgreSQL wire protocol:
-
-```yaml
-local_pg_wire_config:
-    ssl_certificate: "/opt/ydb/certs/node.crt"
-```
-
 ### Kafka Wire Protocol
 
 {{ ydb-short-name }} exposes a separate network port for the [Kafka wire protocol](../../reference/kafka-api/index.md). This protocol is used for external communication with client applications initially designed to work with [Apache Kafka](https://kafka.apache.org/).
diff --git a/ydb/docs/en/core/reference/docker/configuration.md b/ydb/docs/en/core/reference/docker/configuration.md
@@ -6,8 +6,6 @@
 
 | Name | Type | Default  | Description |
 | -- | -- | -- | -- |
-| [`POSTGRES_USER`](https://GitHub.com/ydb-platform/ydb/blob/c113fcffa7b1a20ad8dcb1b1760ae5bfa25370ca/ydb/public/tools/lib/cmds/__init__.py#L240) | `string` | `postgres`  | User name for access via [compatibility with PostgreSQL](../../postgresql/intro.md) |
-| [`POSTGRES_PASSWORD`](https://GitHub.com/ydb-platform/ydb/blob/c113fcffa7b1a20ad8dcb1b1760ae5bfa25370ca/ydb/public/tools/lib/cmds/__init__.py#L240) | `string` | | User password for access via [compatibility with PostgreSQL](../../postgresql/intro.md) |
 | [`YDB_GRPC_ENABLE_TLS`](https://GitHub.com/ydb-platform/ydb/blob/c113fcffa7b1a20ad8dcb1b1760ae5bfa25370ca/ydb/public/tools/lib/cmds/__init__.py#L258) | `0` or `1` | `1` | Enable the `grpcs://` protocol (gRPC over TLS) |
 | [`YDB_GRPC_TLS_DATA_PATH`](https://GitHub.com/ydb-platform/ydb/blob/8fefc809c83829d8d8b886e82534d009de4c8826/ydb/public/tools/lib/cmds/__init__.py#L291) | `string` | `/ydb_data` | Data path with TLS certificates for the `grpcs://` connection |
 | [`MON_PORT`](https://GitHub.com/ydb-platform/ydb/blob/8dde59cd0af86737d07a1cd8ff19811a2bd2b663/ydb/tests/library/harness/kikimr_port_allocator.py#L170) | `int` | `8765` | HTTP port of [Embedded UI](../../reference/embedded-ui/index.md) |
diff --git a/ydb/docs/en/core/reference/index.md b/ydb/docs/en/core/reference/index.md
@@ -3,7 +3,6 @@
 This documentation section contains reference information about various aspects of {{ ydb-short-name }}, including:
 
 * [{#T}](../yql/reference/index.md)
-* [{#T}](../postgresql/intro.md)
 * [{#T}](./embedded-ui/index.md)
 * [{#T}](../integrations/index.md)
 * [{#T}](./ydb-cli/index.md)
diff --git a/ydb/docs/en/core/reference/toc_p.yaml b/ydb/docs/en/core/reference/toc_p.yaml
@@ -4,8 +4,7 @@ items:
   include:
     mode: link
     path: ../yql/toc_p.yaml
-- name: Compatibility with PostgreSQL
-  href: ../postgresql/intro.md
+- name: PostgreSQL compatibility
   include:
     mode: link
     path: ../postgresql/toc_p.yaml
diff --git a/ydb/docs/en/core/security/encryption/data-in-transit.md b/ydb/docs/en/core/security/encryption/data-in-transit.md
@@ -6,7 +6,6 @@ As {{ ydb-short-name }} is a distributed system typically running on a cluster,
 * {{ ydb-short-name }} as a server:
 
   * [gRPC](../../reference/ydb-sdk/overview-grpc-api.md) for external communication with client applications designed to work natively with {{ ydb-short-name }} via the [SDK](../../reference/ydb-sdk/index.md) or [CLI](../../reference/ydb-cli/index.md).
-  * [PostgreSQL wire protocol](../../postgresql/intro.md) for external communication with client applications initially designed to work with [PostgreSQL](https://www.postgresql.org/).
   * [Kafka wire protocol](../../reference/kafka-api/index.md) for external communication with client applications initially designed to work with [Apache Kafka](https://kafka.apache.org/).
   * HTTP for running the [Embedded UI](../../reference/embedded-ui/index.md), exposing [metrics](../../devops/observability/monitoring.md), and other miscellaneous endpoints.
 
diff --git a/ydb/docs/ru/core/dev/getting-started.md b/ydb/docs/ru/core/dev/getting-started.md
@@ -11,7 +11,6 @@
 Выберите {{ ydb-short-name }} API, который вы будете использовать; есть несколько вариантов:
 
 - Для основных языков программирования рекомендуется использовать [{{ ydb-short-name }} SDK](../reference/ydb-sdk/index.md). Они предоставляют высокоуровневые API и реализуют рекомендованные подходы по работе с {{ ydb-short-name }}. {{ ydb-short-name }} SDK доступны для нескольких популярных языков и стремятся к равенству функциональности, но не все из них являются полнофункциональными. Обратитесь к [таблице сравнения функций SDK](../reference/ydb-sdk/feature-parity.md), чтобы проверить, соответствует ли SDK для выбранного языка программирования вашим потребностям, также с её помощью можно выбрать язык программирования с лучшим охват функций, если вы гибки в этом вопросе.
-- Альтернативно, {{ ydb-short-name }} предоставляет [PostgreSQL-совместимый API](../postgresql/intro.md). Он предназначен для упрощения миграции существующих приложений, которые переросли PostgreSQL. Однако это также полезно для экзотических языков программирования, для которых есть клиентская библиотека PostgreSQL, но нет {{ ydb-short-name }} SDK. Обратитесь к документации по совместимости PostgreSQL, чтобы проверить, соответствует ли ее полнота вашим потребностям.
 - Если вас интересует функция [{{ ydb-short-name }} топиков](../concepts/datamodel/topic.md), стоит отметить, что они предоставляют [Kafka-совместимый API](../reference/kafka-api/index.md). Перейдите по этой ссылке, если этот вариант использования для вас актуален.
 - В крайнем случае, собственный API {{ ydb-short-name }} основан на протоколе [gRPC](https://grpc.io/), вокруг которого есть экосистема, включая генерацию кода клиентов. [gRPC спецификации {{ ydb-short-name}} API](https://github.com/ydb-platform/ydb/tree/main/ydb/public/api/grpc) размещены на GitHub, и вы можете использовать их в своём приложении. Сгенерированные клиенты являются низкоуровневыми и потребуют дополнительной работы для правильной обработки таких аспектов, как ретраи и таймауты. Следуйте по этому пути только если другие варианты невозможны, и вы знаете, что делаете.
 
diff --git a/ydb/docs/ru/core/dev/index.md b/ydb/docs/ru/core/dev/index.md
@@ -23,7 +23,6 @@
   - [{#T}](../yql/reference/index.md)
   - [{#T}](../reference/ydb-sdk/index.md)
   - [{#T}](../reference/ydb-cli/index.md)
-  - [{#T}](../postgresql/intro.md)
   - [{#T}](../reference/kafka-api/index.md)
 
 
diff --git a/ydb/docs/ru/core/index.yaml b/ydb/docs/ru/core/index.yaml
@@ -37,9 +37,6 @@ links:
   - title: Работа с SDK
     description: Справочник по YDB Software Development Kits
     href: reference/ydb-sdk/
-  - title: Совместимость с PostgreSQL
-    description: Интеграция с экосистемой PostgreSQL
-    href: postgresql/intro/
   - title: Диагностика проблем
     description: Описание диагностики проблем с базами данных YDB и приложениями
     href: troubleshooting/
diff --git a/ydb/docs/ru/core/integrations/index.md b/ydb/docs/ru/core/integrations/index.md
@@ -46,5 +46,4 @@
 ## Смотрите также
 
 * [{#T}](../reference/ydb-sdk/index.md)
-* [{#T}](../postgresql/intro.md)
 * [{#T}](../reference/kafka-api/index.md)
diff --git a/ydb/docs/ru/core/postgresql/toc_i.yaml b/ydb/docs/ru/core/postgresql/toc_i.yaml
@@ -1,6 +1,6 @@
 items:
 - name: Описание
-  href: ../postgresql/intro.md
+  href: intro.md
 - name: Выполнение запросов
   href: connect.md
 - name: Интероперабельность PostgreSQL и {{ydb-name}}
diff --git a/ydb/docs/ru/core/reference/configuration/tls.md b/ydb/docs/ru/core/reference/configuration/tls.md
@@ -32,17 +32,6 @@ grpc_config:
    ca: "/opt/ydb/certs/ca.crt"
 ```
 
-### Протокол PostgreSQL
-
-{{ ydb-short-name }} открывает отдельный сетевой порт для [протокола PostgreSQL](../../postgresql/intro.md). Этот протокол используется для внешнего взаимодействия с клиентскими приложениями, изначально разработанными для работы с [PostgreSQL](https://www.postgresql.org/).
-
-Пример включения TLS для протокола PostgreSQL:
-
-```yaml
-local_pg_wire_config:
-    ssl_certificate: "/opt/ydb/certs/node.crt"
-```
-
 ### Протокол Kafka
 
 {{ ydb-short-name }} открывает отдельный сетевой порт для [протокола Kafka](../../reference/kafka-api/index.md). Этот протокол используется для внешнего взаимодействия с клиентскими приложениями, изначально разработанными для работы с [Apache Kafka](https://kafka.apache.org/).
diff --git a/ydb/docs/ru/core/reference/docker/configuration.md b/ydb/docs/ru/core/reference/docker/configuration.md
@@ -6,8 +6,6 @@
 
 | Имя | Тип | Значение по умолчанию | Описание |
 | -- | -- | -- | -- |
-| [`POSTGRES_USER`](https://GitHub.com/ydb-platform/ydb/blob/c113fcffa7b1a20ad8dcb1b1760ae5bfa25370ca/ydb/public/tools/lib/cmds/__init__.py#L240) | `string` | `postgres`  | Имя пользователя для доступа через [режим совместимости с PostgreSQL](../../postgresql/intro.md). |
-| [`POSTGRES_PASSWORD`](https://GitHub.com/ydb-platform/ydb/blob/c113fcffa7b1a20ad8dcb1b1760ae5bfa25370ca/ydb/public/tools/lib/cmds/__init__.py#L240) | `string` | | Пароль пользователя для доступа через [режим совместимости с PostgreSQL](../../postgresql/intro.md). |
 | [`YDB_GRPC_ENABLE_TLS`](https://GitHub.com/ydb-platform/ydb/blob/c113fcffa7b1a20ad8dcb1b1760ae5bfa25370ca/ydb/public/tools/lib/cmds/__init__.py#L258) | `0` или `1` | `1` | Включает использование TLS для gRPC соединений. |
 | [`YDB_GRPC_TLS_DATA_PATH`](https://GitHub.com/ydb-platform/ydb/blob/8fefc809c83829d8d8b886e82534d009de4c8826/ydb/public/tools/lib/cmds/__init__.py#L291) | `string` | `/ydb_data` | Путь до директории с TLS сертификатами для gRPC соединений. |
 | [`MON_PORT`](https://GitHub.com/ydb-platform/ydb/blob/8dde59cd0af86737d07a1cd8ff19811a2bd2b663/ydb/tests/library/harness/kikimr_port_allocator.py#L170) | `int` | `8765` | HTTP-порт [встроенного веб-интерфейса {{ ydb-short-name }}](../../reference/embedded-ui/index.md). |
diff --git a/ydb/docs/ru/core/reference/index.md b/ydb/docs/ru/core/reference/index.md
@@ -3,7 +3,6 @@
 В этом разделе документации содержится справочная информация по различным аспектам {{ ydb-short-name }}, включая:
 
 * [{#T}](../yql/reference/index.md)
-* [{#T}](../postgresql/intro.md)
 * [{#T}](./embedded-ui/index.md)
 * [{#T}](../integrations/index.md)
 * [{#T}](./ydb-cli/index.md)
diff --git a/ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md b/ydb/docs/ru/core/reference/ydb-cli/_includes/commands.md
@@ -99,9 +99,6 @@ debug ping | Проверка доступности {{ ydb-short-name }}
 [tools copy](../tools-copy.md) | Копирование [таблиц](../../../concepts/glossary.md#table)
 [tools dump](../export-import/tools-dump.md#schema-objects) | Выгрузка отдельных схемных объектов в файловую систему
 [tools infer csv](../tools-infer.md) | Генерация текста запроса `CREATE TABLE SQL` из CSV файла
-{% if ydb-cli == "ydb" %}
-[tools pg-convert](../../../postgresql/import.md#pg-convert) | Конвертация дампа PostgreSQL, полученного утилитой pg_dump, в формат, понятный YDB
-{% endif %}
 [tools rename](../commands/tools/rename.md) | Переименование строковых [таблиц](../../../concepts/glossary.md#row-oriented-table)
 [tools restore](../export-import/tools-restore.md#schema-objects) | Восстановление отдельных схемных объектов из файловой системы
 [topic create](../topic-create.md) | Создание [топика](../../../concepts/glossary.md#topic)
diff --git a/ydb/docs/ru/core/security/encryption/data-in-transit.md b/ydb/docs/ru/core/security/encryption/data-in-transit.md
diff --git a/ydb/docs/ru/core/yql/reference/syntax/create-topic.md b/ydb/docs/ru/core/yql/reference/syntax/create-topic.md
