Unique constraint docs (en, ru)

ydb/docs/en/core/concepts/_includes/secondary_indexes.md

@@ -21,6 +21,14 @@ Unlike a synchronous index, an asynchronous index doesn't use distributed transa
 
 You can copy the contents of columns into a covering index. This eliminates the need to read data from the main table when performing reads by index and significantly reduces delays. At the same time, such denormalization leads to increased usage of disk space and may slow down inserts and updates due to the need for additional data copying.
 
+## Unique secondary index {#unique}
+
+This type of index allows to get unique constraint behaviour. The query processor uses it to perform additional checks to guarantee indexed set of columns present just once in the table. If SQL modification of table brokes the constraint the coresponding query will be canceled with PRECONDITION_FAILED status. So user code must be ready to handle this status. Unique secondaty indes is a synchronous index so update process is same as in the [Synchronous secondary](#sync) described above from transaction perspective.
+
+As other this index allows to perform efficient point lookup query.
+
+Currently unique index can't be added in to existed table.
+
 ## Creating a secondary index online {#index-add}
 
 {{ ydb-short-name }} lets you create new and delete existing secondary indexes without stopping the service. For a single table, you can only create one index at a time.

ydb/docs/en/core/yql/reference/yql-core/syntax/_includes/create_table.md

@@ -102,7 +102,7 @@ The `INDEX` clause is used to define a {% if concept_secondary_index %}[secondar
 ```yql
 CREATE TABLE table_name (
     ...
-    INDEX <index_name> GLOBAL [SYNC|ASYNC] ON ( <index_columns> ) COVER ( <cover_columns> ),
+    INDEX <index_name> GLOBAL [UNIQUE] [SYNC|ASYNC] ON ( <index_columns> ) COVER ( <cover_columns> ),
     ...
 )
 ```
@@ -111,6 +111,7 @@ Where:
 
 * **Index_name** is the unique name of the index to be used to access data.
 * **SYNC/ASYNC** indicates synchronous/asynchronous data writes to the index. If not specified, synchronous.
+* **UNIQUE** indicates index should gurantee unique property for indexed column set thereby implements unique constraint.
 * **Index_columns** is a list of comma-separated names of columns in the created table to be used for a search in the index.
 * **Cover_columns** is a list of comma-separated names of columns in the created table, which will be stored in the index in addition to the search columns, making it possible to fetch additional data without accessing the table for it.
 
@@ -124,6 +125,7 @@ CREATE TABLE my_table (
     d Date,
     INDEX idx_d GLOBAL ON (d),
     INDEX idx_ba GLOBAL ASYNC ON (b, a) COVER (c),
+    INDEX idx_bc GLOBAL UNIQUE SYNC ON (b, c),
     PRIMARY KEY (a)
 )
 ```

ydb/docs/en/core/yql/reference/yql-core/syntax/create_table/secondary_index.md

@@ -7,7 +7,7 @@ The INDEX construct is used to define a {% if concept_secondary_index %}[seconda
 ```yql
 CREATE TABLE table_name (
     ...
-    INDEX <index_name> GLOBAL [SYNC|ASYNC] ON ( <index_columns> ) COVER ( <cover_columns> ),
+    INDEX <index_name> GLOBAL [UNIQUE] [SYNC|ASYNC] ON ( <index_columns> ) COVER ( <cover_columns> ),
     ...
 )
 ```
@@ -16,6 +16,7 @@ Where:
 
 * **Index_name** is the unique name of the index to be used to access data.
 * **SYNC/ASYNC** indicates synchronous/asynchronous data writes to the index. If not specified, synchronous.
+* **UNIQUE** indicates index should gurantee unique property for indexed column set thereby implements unique constraint.
 * **Index_columns** is a list of comma-separated names of columns in the created table to be used for a search in the index.
 * **Cover_columns** is a list of comma-separated names of columns in the created table, which will be stored in the index in addition to the search columns, making it possible to fetch additional data without accessing the table for it.
 
@@ -29,6 +30,7 @@ CREATE TABLE my_table (
     d Date,
     INDEX idx_d GLOBAL ON (d),
     INDEX idx_ba GLOBAL ASYNC ON (b, a) COVER (c),
+    INDEX idx_bc GLOBAL UNIQUE SYNC ON (b, c),
     PRIMARY KEY (a)
 )
-```
+```

ydb/docs/ru/core/concepts/_includes/secondary_indexes.md

@@ -21,6 +21,14 @@
 
 Имеется возможность сделать копию содержимого колонок в индекс (covering index), таким образом это исключает необходимость чтения из основной таблицы в операциях чтения по индексу, что заметно снижает задержки. В то же время такая денормализация приводит к увеличенному потреблению дискового пространства и к возможному замедлению операции вставки и обновления из-за необходимости дополнительного копирования данных.
 
+## Уникальный вторичный индекс {#unique}
+
+Этот тип индекса реализует семантику уникального значения в колонке или наборе колонок. Процессор запросов использует его для выполнения дополнительных проверок, чтобы гарантировать, что набор индексированных колонок присутствует в таблице только один раз. Если SQL-модификация таблицы нарушает это ограничение, соответствующий запрос будет отменен со статусом PRECONDITION_FAILED. Таким образом пользовательский код должен быть готов к обработке этого статуса. Уникальный вторичный индекс является синхронным индексом, поэтому процесс обновления происходит так же, как описано в разделе Синхронный вторичный с точки зрения транзакции.
+
+Как и другие индексы, этот индекс позволяет эффективно выполнять точечные чтения по набору индексируемых колонок.
+
+В настоящее время уникальный индекс не может быть добавлен в существующую таблицу.
+
 ## Онлайн-создание вторичного индекса {#index-add}
 
 В {{ ydb-short-name }} доступно создание вторичного индекса, а также удаление существующего вторичного индекса без остановки обслуживания. Для одной таблицы можно создать только один индекс за раз.

ydb/docs/ru/core/yql/reference/yql-core/syntax/_includes/create_table.md

@@ -102,7 +102,7 @@
 ```yql
 CREATE TABLE table_name (
     ...
-    INDEX <index_name> GLOBAL [SYNC|ASYNC] ON ( <index_columns> ) COVER ( <cover_columns> ),
+    INDEX <index_name> GLOBAL [UNIQUE] [SYNC|ASYNC] ON ( <index_columns> ) COVER ( <cover_columns> )
     ...
 )
 ```
@@ -111,6 +111,7 @@ CREATE TABLE table_name (
 
 * **index_name** — уникальное имя индекса, по которому будет возможно обращение к данным.
 * **SYNC/ASYNC** — синхронная или асинхронная запись в индекс, если не указано — синхронная.
+* **UNIQUE** - создает индекс с гарантией уникальности для вставляемых значений.
 * **index_columns** — имена колонок создаваемой таблицы через запятую, по которым возможен поиск в индексе.
 * **cover_columns** — имена колонок создаваемой таблицы через запятую, которые будет сохранены в индексе дополнительно к колонкам поиска, давая возможность получить дополнительные данные без обращения за ними в таблицу.
 
@@ -124,6 +125,7 @@ CREATE TABLE my_table (
     d Date,
     INDEX idx_d GLOBAL ON (d),
     INDEX idx_ba GLOBAL ASYNC ON (b, a) COVER (c),
+    INDEX idx_bc GLOBAL UNIQUE SYNC ON (b, c),
     PRIMARY KEY (a)
 )
 ```

ydb/docs/ru/core/yql/reference/yql-core/syntax/create_table/secondary_index.md

@@ -20,6 +20,7 @@ CREATE TABLE table_name (
 
 * **index_name** — уникальное имя индекса, по которому будет возможно обращение к данным.
 * **SYNC/ASYNC** — синхронная или асинхронная запись в индекс, если не указано — синхронная.
+* **UNIQUE** - создает индекс с гарантией уникальности для вставляемых значений.
 * **index_columns** — имена колонок создаваемой таблицы через запятую, по которым возможен поиск в индексе.
 * **cover_columns** — имена колонок создаваемой таблицы через запятую, которые будет сохранены в индексе дополнительно к колонкам поиска, давая возможность получить дополнительные данные без обращения за ними в таблицу.
 
@@ -39,6 +40,7 @@ CREATE TABLE table_name (
       d Date,
       INDEX idx_d GLOBAL ON (d),
       INDEX idx_ba GLOBAL ASYNC ON (b, a) COVER (c),
+      INDEX idx_bc GLOBAL UNIQUE SYNC ON (b, c),
       PRIMARY KEY (a)
   )
   ```
@@ -78,4 +80,4 @@ CREATE TABLE my_table (
 )
 ```
 
-{% endif %}
+{% endif %}