Skip to content

Commit eab2f6c

Browse files
vgvolegblinkov
andauthored
Apply suggestions from code review
Co-authored-by: Ivan Blinkov <ivan@blinkov.ru>
1 parent c6730e1 commit eab2f6c

File tree

1 file changed

+6
-8
lines changed
  • ydb/docs/ru/core/dev/example-app/python

1 file changed

+6
-8
lines changed

ydb/docs/ru/core/dev/example-app/python/index.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ python3 -m pip install iso8601
6363

6464
{% include [create_table.md](../_includes/steps/02_create_table.md) %}
6565

66-
Для создания таблиц используется метод `pool.execute_with_retries()`:
66+
Для выполнения YQL запросов используется метод `pool.execute_with_retries()`. Например, можно создать строковые таблицы:
6767

6868
{% list tabs %}
6969

@@ -185,9 +185,7 @@ python3 -m pip install iso8601
185185
full_path = os.path.join(database, path)
186186
```
187187

188-
Функция `pool.execute_with_retries(query)`, в отличие от `tx.execute()`, загружает в память результат запроса до его возвращения клиенту.
189-
Благодаря этому нет необходимости использовать специальные контрукции для контроля над стримом, однако нужно с осторожностью пользоваться данным методом с большими `SELECT` запросами.
190-
Подробнее про стримы будет сказано ниже.
188+
Функция `pool.execute_with_retries(query)`, в отличие от `tx.execute()`, загружает в память результат запроса перед его возвращением клиенту. Благодаря этому отпадает необходимость использования специальных конструкций для контроля над стримом, однако необходимо с осторожностью применять этот метод для больших запросов `SELECT`. Подробнее о стримах будет сказано ниже.
191189

192190
{% include [steps/03_write_queries.md](../_includes/steps/03_write_queries.md) %}
193191

@@ -311,7 +309,7 @@ series, Id: 1, title: IT Crowd, Release date: 2006-02-03
311309
Для выполнения параметризованных запросов в метод `pool.execute_with_retries()` (или `tx.execute()`, работа с которым будет показана в следующей секции) необходимо передать словарь с параметрами специального вида, где ключом служит имя параметра, а значение может быть одним из следующих:
312310
1. Обычное значение;
313311
2. Кортеж со значением и типом;
314-
3. Специальный тип ydb.TypedValue(value=value, value_type=value_type).
312+
3. Специальный тип `ydb.TypedValue(value=value, value_type=value_type)`.
315313

316314
В случае указания значения без типа, конвертация происходит по следующим правилам:
317315
* `int` -> `ydb.PrimitiveType.Int64`
@@ -343,7 +341,7 @@ series, Id: 1, title: IT Crowd, Release date: 2006-02-03
343341
path
344342
),
345343
{
346-
"$seriesId": series_id, # could be defined implicit
344+
"$seriesId": series_id, # data type could be defined implicitly
347345
"$seasonId": (season_id, ydb.PrimitiveType.Int64), # could be defined via tuple
348346
"$episodeId": ydb.TypedValue(episode_id, ydb.PrimitiveType.Int64), # could be defined via special class
349347
},
@@ -509,5 +507,5 @@ SDK позволяет в явном виде контролировать вы
509507

510508
{% endlist %}
511509

512-
Однако, стоит помнить, что транзакция может быть открыта неявно при первом запросе. Завершиться же она может автоматически с помощью явного указания флага: `commit_tx=True`.
513-
Неявное управление транзакцией является предпочтительным, так как используется меньше обращений на сервер.
510+
Однако стоит помнить, что транзакция может быть открыта неявно при первом запросе. Завершиться же она может автоматически с явным указанием флага `commit_tx=True`.
511+
Неявное управление транзакцией предпочтительно, так как требует меньше обращений к серверу.

0 commit comments

Comments
 (0)