mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-12 11:30:49 +00:00
0a4a5b36cc
* Additional .gitignore entries * Merge a bunch of small articles about system tables into single one * Merge a bunch of small articles about formats into single one * Adapt table with formats to English docs too * Add SPb meetup link to main page * Move Utilities out of top level of docs (the location is probably not yet final) + translate couple articles * Merge MacOS.md into build_osx.md * Move Data types higher in ToC * Publish changelog on website alongside documentation * Few fixes for en/table_engines/file.md * Use smaller header sizes in changelogs * Group up table engines inside ToC * Move table engines out of top level too * Specificy in ToC that query language is SQL based. Thats a bit excessive, but catches eye. * Move stuff that is part of query language into respective folder * Move table functions lower in ToC * Lost redirects.txt update * Do not rely on comments in yaml + fix few ru titles * Extract major parts of queries.md into separate articles * queries.md has been supposed to be removed * Fix weird translation * Fix a bunch of links * There is only table of contents left * "Query language" is actually part of SQL abbreviation * Change filename in README.md too * fix mistype
50 lines
2.9 KiB
Markdown
50 lines
2.9 KiB
Markdown
# Internal dictionaries
|
|
|
|
ClickHouse contains a built-in feature for working with a geobase.
|
|
|
|
This allows you to:
|
|
|
|
- Use a region's ID to get its name in the desired language.
|
|
- Use a region's ID to get the ID of a city, area, federal district, country, or continent.
|
|
- Check whether a region is part of another region.
|
|
- Get a chain of parent regions.
|
|
|
|
All the functions support "translocality," the ability to simultaneously use different perspectives on region ownership. For more information, see the section "Functions for working with Yandex.Metrica dictionaries".
|
|
|
|
The internal dictionaries are disabled in the default package.
|
|
To enable them, uncomment the parameters `path_to_regions_hierarchy_file` and `path_to_regions_names_files` in the server configuration file.
|
|
|
|
The geobase is loaded from text files.
|
|
If you work at Yandex, you can follow these instructions to create them:
|
|
<https://github.yandex-team.ru/raw/Metrika/ClickHouse_private/master/doc/create_embedded_geobase_dictionaries.txt>
|
|
|
|
Put the regions_hierarchy\*.txt files in the path_to_regions_hierarchy_file directory. This configuration parameter must contain the path to the regions_hierarchy.txt file (the default regional hierarchy), and the other files (regions_hierarchy_ua.txt) must be located in the same directory.
|
|
|
|
Put the `regions_names_*.txt` files in the path_to_regions_names_files directory.
|
|
|
|
You can also create these files yourself. The file format is as follows:
|
|
|
|
`regions_hierarchy*.txt`: TabSeparated (no header), columns:
|
|
|
|
- Region ID (UInt32)
|
|
- Parent region ID (UInt32)
|
|
- Region type (UInt8): 1 - continent, 3 - country, 4 - federal district, 5 - region, 6 - city; other types don't have values.
|
|
- Population (UInt32) - Optional column.
|
|
|
|
`regions_names_*.txt`: TabSeparated (no header), columns:
|
|
|
|
- Region ID (UInt32)
|
|
- Region name (String) - Can't contain tabs or line feeds, even escaped ones.
|
|
|
|
A flat array is used for storing in RAM. For this reason, IDs shouldn't be more than a million.
|
|
|
|
Dictionaries can be updated without restarting the server. However, the set of available dictionaries is not updated.
|
|
For updates, the file modification times are checked. If a file has changed, the dictionary is updated.
|
|
The interval to check for changes is configured in the 'builtin_dictionaries_reload_interval' parameter.
|
|
Dictionary updates (other than loading at first use) do not block queries. During updates, queries use the old versions of dictionaries. If an error occurs during an update, the error is written to the server log, and queries continue using the old version of dictionaries.
|
|
|
|
We recommend periodically updating the dictionaries with the geobase. During an update, generate new files and write them to a separate location. When everything is ready, rename them to the files used by the server.
|
|
|
|
There are also functions for working with OS identifiers and Yandex.Metrica search engines, but they shouldn't be used.
|
|
|