You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: ydb/docs/en/core/changelog-cli.md
-5Lines changed: 0 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -272,7 +272,6 @@ Released on November 26, 2024. To update to version **2.16.0**, select the [Down
272
272
* Added support for [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)–formatted timestamps in the `{{ ydb-cli }} topic` commands.
273
273
* Added the `--explain-ast` option to the `{{ ydb-cli }} sql` command, which prints the query AST.
274
274
* Added ANSI SQL syntax highlighting in interactive mode.
275
-
* Added support for [PostgreSQL syntax](./postgresql/intro.md) in the `{{ ydb-cli }} workload tpch` and `{{ ydb-cli }} workload tpcds` benchmarks.
276
275
* Introduced the `-c` option for the `{{ ydb-cli }} workload tpcds run` command to compare results with expected values and display differences.
277
276
* Added log events for the `{{ ydb-cli }} tools dump` and `{{ ydb-cli }} tools restore` commands.
278
277
* Enhanced the `{{ ydb-cli }} tools restore` command to display error locations.
@@ -342,7 +341,6 @@ Released on January 12, 2024. To update to version **2.8.0**, select the [Downlo
342
341
### Features
343
342
344
343
* Added new `{{ ydb-cli }} admin config` and `{{ ydb-cli }} admin volatile-config` commands for cluster configuration management.
345
-
* Added support for loading PostgreSQL-compatible data types by [ydb import file csv|tsv|json](reference/ydb-cli/export-import/import-file.md) command. Only for row-oriented tables.
346
344
* Added support for directory load from an S3-compatible storage in the [ydb import s3](reference/ydb-cli/export-import/import-s3.md) command. Currently only available on Linux and Mac OS.
347
345
* Added support for outputting the results of [ydb table query execute](reference/ydb-cli/table-query-execute.md), [ydb yql](reference/ydb-cli/yql.md) and [ydb scripting yql](reference/ydb-cli/scripting-yql.md) commands in the [Apache Parquet](https://parquet.apache.org/docs/) format.
348
346
* In the [ydb workload](reference/ydb-cli/commands/workload/index.md) commands, the `--executer` option has been added, which allows to specify which type of queries to use.
@@ -354,15 +352,12 @@ Released on January 12, 2024. To update to version **2.8.0**, select the [Downlo
354
352
355
353
* Fixed an error displaying tables in `pretty` format with [Unicode](https://en.wikipedia.org/wiki/Unicode) characters.
356
354
357
-
* Fixed an error substituting the wrong primary key in the command [ydb tools pg-convert](postgresql/import.md#pg-convert).
358
-
359
355
## Version 2.7.0 {#2-7-0}
360
356
361
357
Released on October 23, 2023. To update to version **2.7.0**, select the [Downloads](downloads/ydb-cli.md) section.
362
358
363
359
### Features
364
360
365
-
* 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.
366
361
* 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.
367
362
* Added new `{{ ydb-cli }} scheme permissions list` command to list permissions.
368
363
* 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.
Copy file name to clipboardExpand all lines: ydb/docs/en/core/dev/getting-started.md
+1-10Lines changed: 1 addition & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,36 +11,27 @@ In parallel with designing the schema, you need to set up your development envir
11
11
Choose the {{ ydb-short-name }} API you want to use; there are several options:
12
12
13
13
- 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.
14
-
- 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.
15
14
- 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.
16
15
- 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.
17
16
18
17
## Install prerequisites
19
18
20
-
Choose the specific programming language you'll be using. [Install the respective {{ ydb-short-name }} SDK](../reference/ydb-sdk/index.md) or [a PostgreSQL driver](https://wiki.postgresql.org/wiki/List_of_drivers) depending on the route you have chosen above.
19
+
Choose the specific programming language you'll be using. [Install the respective {{ ydb-short-name }} SDK](../reference/ydb-sdk/index.md).
21
20
22
21
Additionally, you'd want to set up at least one of the available ways to run ad-hoc queries for debugging purposes. Choose at least one according to your preferences:
* Any SQL IDE that supports [JDBC](https://github.com/ydb-platform/ydb-jdbc-driver)
27
-
*[psql](https://www.postgresql.org/docs/14/app-psql.html) or [pgAdmin](https://www.pgadmin.org/) for the PostgreSQL-compatible route.
28
26
29
27
## Start coding
30
28
31
-
### For {{ ydb-short-name }} SDK route
32
-
33
29
- Go through [YQL tutorial](yql-tutorial/index.md) to get familiar with {{ ydb-short-name }}'s SQL dialect.
34
30
- Explore [example applications](example-app/index.md) to see how working with SDK's looks like.
35
31
- Check out [SDK recipies](../recipes/ydb-sdk/index.md) for typical SDK use cases, which you can refer to later.
36
32
- Learn how to [handle {{ ydb-short-name }} SDK errors](../reference/ydb-sdk/error_handling.md).
37
33
- Leverage your IDE capabilities to navigate the SDK code.
38
34
39
-
### For PostgreSQL-compatibility route
40
-
41
-
- Learn how to [connect PostgreSQL driver with {{ ydb-short-name }} cluster](../postgresql/docker-connect.md).
42
-
- 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.
43
-
44
35
## Testing
45
36
46
37
To write tests on applications working with {{ ydb-short-name }}:
Copy file name to clipboardExpand all lines: ydb/docs/en/core/dev/index.md
-1Lines changed: 0 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,6 @@ Main resources:
24
24
-[{#T}](../yql/reference/index.md)
25
25
-[{#T}](../reference/ydb-sdk/index.md)
26
26
-[{#T}](../reference/ydb-cli/index.md)
27
-
-[{#T}](../postgresql/intro.md)
28
27
-[{#T}](../reference/kafka-api/index.md)
29
28
30
29
If you're interested in developing {{ ydb-short-name }} core or satellite projects, refer to the [documentation for contributors](../contributor/index.md).
Copy file name to clipboardExpand all lines: ydb/docs/en/core/integrations/index.md
+1-2Lines changed: 1 addition & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ This section provides the main information about {{ ydb-name }} integrations wit
4
4
5
5
{% note info %}
6
6
7
-
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.
7
+
In addition to its own native protocol, {{ ydb-name }} has a compatibility layer that allows external systems to connect to databases via the Apache Kafka network protocol. Due to the compatibility layer, many tools designed to work with Apache Kafka can also interact with {{ ydb-name }}. The compatibility level of each specific application needs to be clarified separately.
8
8
9
9
{% endnote %}
10
10
@@ -44,5 +44,4 @@ In addition to its own native protocol, {{ ydb-name }} has a compatibility layer
Copy file name to clipboardExpand all lines: ydb/docs/en/core/reference/configuration/tls.md
-11Lines changed: 0 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,17 +32,6 @@ grpc_config:
32
32
ca: "/opt/ydb/certs/ca.crt"
33
33
```
34
34
35
-
### PostgreSQL Wire Protocol
36
-
37
-
{{ 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/).
38
-
39
-
Example of enabling TLS for the PostgreSQL wire protocol:
40
-
41
-
```yaml
42
-
local_pg_wire_config:
43
-
ssl_certificate: "/opt/ydb/certs/node.crt"
44
-
```
45
-
46
35
### Kafka Wire Protocol
47
36
48
37
{{ 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/).
Copy file name to clipboardExpand all lines: ydb/docs/en/core/security/encryption/data-in-transit.md
-1Lines changed: 0 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,6 @@ As {{ ydb-short-name }} is a distributed system typically running on a cluster,
6
6
* {{ ydb-short-name }} as a server:
7
7
8
8
*[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).
9
-
*[PostgreSQL wire protocol](../../postgresql/intro.md) for external communication with client applications initially designed to work with [PostgreSQL](https://www.postgresql.org/).
10
9
*[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/).
11
10
* HTTP for running the [Embedded UI](../../reference/embedded-ui/index.md), exposing [metrics](../../devops/observability/monitoring.md), and other miscellaneous endpoints.
0 commit comments