ClickHouse/docs/ru/dicts/external_dicts.rst

.. _dicts-external_dicts:

***************
Внешние словари
***************

Существует возможность подключать собственные словари из различных источников данных. Источником данных для словаря может быть локальный текстовый/исполняемый файл, HTTP(s) ресурс или другая СУБД. Подробнее смотрите в разделе ":ref:`dicts-external_dicts_dict_sources`".

ClickHouse:

 * Полностью или частично хранит словари в оперативной памяти.
 * Периодически обновляет их и динамически подгружает отсутствующие значения. Т.е. словари можно подгружать динамически.

Конфигурация внешних словарей находится в одном или нескольких файлах. Путь к конфигурации указывается в параметре :ref:`server_settings-dictionaries_config`.

Словари могут загружаться при старте сервера или при первом использовании, в зависимости от настройки :ref:`server_settings-dictionaries_lazy_load`.

Конфигурационный файл словарей имеет вид:

.. code-block:: xml

  <dictionaries>
      <comment>Необязательный элемент с любым содержимым. Игнорируется сервером ClickHouse.</comment>
  
      <dictionary>
          <!-- Конфигурация словаря -->
      </dictionary>

      ...

      <dictionary>
          <!-- Конфигурация словаря -->
      </dictionary>
  </dictionaries>

В одном файле можно :ref:`сконфигурировать <dicts-external_dicts_dict>` произвольное количество словарей. Формат файла сохраняется даже если словарь один (т.е. ``<dictionaries><dictionary> <!--configuration--> </dictionary></dictionaries>``).

Смотрите также ":ref:`ext_dict_functions`" .

.. attention:: Вы можете преобразовывать значения по небольшому словарю, описав его в запросе ``SELECT`` (см. функцию ":ref:`other_functions-transform`"). Эта функциональность не связана с внешними словарями.

.. toctree::
    :glob:
   
    external_dicts_dict*
-												New part "Server configuration parameters" of the document is added.
Other changes are made related to this new part.

											
										
										
											2017-06-26 07:14:13 +00:00
+								.. _dicts-external_dicts:
-												External dictionaries topic is restructured and updated.

											
										
										
											2017-07-31 08:31:30 +00:00
+								***************
-												Added documentation in RST format. (ReadTheDocs ready)

											
										
										
											2017-03-12 17:58:51 +00:00
+								Внешние словари
-												External dictionaries topic is restructured and updated.

											
										
										
											2017-07-31 08:31:30 +00:00
+								***************
-												Added documentation in RST format. (ReadTheDocs ready)

											
										
										
											2017-03-12 17:58:51 +00:00
-												External dictionaries topic is restructured and updated.

											
										
										
											2017-07-31 08:31:30 +00:00
+								Существует возможность подключать собственные словари из различных источников данных. Источником данных для словаря может быть локальный текстовый/исполняемый файл, HTTP(s) ресурс или другая СУБД. Подробнее смотрите в разделе ":ref:`dicts-external_dicts_dict_sources`".
-												Added documentation in RST format. (ReadTheDocs ready)

											
										
										
											2017-03-12 17:58:51 +00:00
-												<invalidate_query> setting of external dictionaty <source> section is described.

											
										
										
											2017-08-17 14:37:40 +00:00
+								ClickHouse:
-												Added documentation in RST format. (ReadTheDocs ready)

											
										
										
											2017-03-12 17:58:51 +00:00
-												"INSERT" query descripion is updated. Information on performance of query is added.
Session parameter "strict_insert_defaults" is desribed.

											
										
										
											2017-08-31 13:17:51 +00:00
+								 * Полностью или частично хранит словари в оперативной памяти.
-												<invalidate_query> setting of external dictionaty <source> section is described.

											
										
										
											2017-08-17 14:37:40 +00:00
+								 * Периодически обновляет их и динамически подгружает отсутствующие значения. Т.е. словари можно подгружать динамически.
-												Added documentation in RST format. (ReadTheDocs ready)

											
										
										
											2017-03-12 17:58:51 +00:00
-												<invalidate_query> setting of external dictionaty <source> section is described.

											
										
										
											2017-08-17 14:37:40 +00:00
+								Конфигурация внешних словарей находится в одном или нескольких файлах. Путь к конфигурации указывается в параметре :ref:`server_settings-dictionaries_config`.
-												External dictionaries topic is restructured and updated.

											
										
										
											2017-07-31 08:31:30 +00:00
 								Словари могут загружаться при старте сервера или при первом использовании, в зависимости от настройки :ref:`server_settings-dictionaries_lazy_load`.
-												Added documentation in RST format. (ReadTheDocs ready)

											
										
										
											2017-03-12 17:58:51 +00:00
 								Конфигурационный файл словарей имеет вид:
 								.. code-block:: xml
 								  <dictionaries>
-												<invalidate_query> setting of external dictionaty <source> section is described.

											
										
										
											2017-08-17 14:37:40 +00:00
+								      <comment>Необязательный элемент с любым содержимым. Игнорируется сервером ClickHouse.</comment>
-												Added documentation in RST format. (ReadTheDocs ready)

											
										
										
											2017-03-12 17:58:51 +00:00
 								      <dictionary>
-												External dictionaries topic is restructured and updated.

											
										
										
											2017-07-31 08:31:30 +00:00
+								          <!-- Конфигурация словаря -->
-												Added documentation in RST format. (ReadTheDocs ready)

											
										
										
											2017-03-12 17:58:51 +00:00
+								      </dictionary>
 								      ...
-												External dictionaries topic is restructured and updated.

											
										
										
											2017-07-31 08:31:30 +00:00
+								      <dictionary>
 								          <!-- Конфигурация словаря -->
 								      </dictionary>
-												Added documentation in RST format. (ReadTheDocs ready)

											
										
										
											2017-03-12 17:58:51 +00:00
+								  </dictionaries>
-												External dictionaries topic is restructured and updated.

											
										
										
											2017-07-31 08:31:30 +00:00
+								В одном файле можно :ref:`сконфигурировать <dicts-external_dicts_dict>` произвольное количество словарей. Формат файла сохраняется даже если словарь один (т.е. ``<dictionaries><dictionary> <!--configuration--> </dictionary></dictionaries>``).
-												document dictionaries with complex keys

											
										
										
											2017-03-17 18:52:08 +00:00
-												External dictionaries topic is restructured and updated.

											
										
										
											2017-07-31 08:31:30 +00:00
+								Смотрите также ":ref:`ext_dict_functions`" .
-												document dictionaries with complex keys

											
										
										
											2017-03-17 18:52:08 +00:00
-												<invalidate_query> setting of external dictionaty <source> section is described.

											
										
										
											2017-08-17 14:37:40 +00:00
+								.. attention:: Вы можете преобразовывать значения по небольшому словарю, описав его в запросе ``SELECT`` (см. функцию ":ref:`other_functions-transform`"). Эта функциональность не связана с внешними словарями.
-												document dictionaries with complex keys

											
										
										
											2017-03-17 18:52:08 +00:00
-												External dictionaries topic is restructured and updated.

											
										
										
											2017-07-31 08:31:30 +00:00
+								.. toctree::
 								    :glob:
 								    external_dicts_dict*