使用 Yandex.Metrica 字典函数

为了使下面的功能正常工作,服务器配置必须指定获取所有 Yandex.Metrica 字典的路径和地址。Yandex.Metrica 字典在任何这些函数的第一次调用时加载。 如果无法加载引用列表,则会引发异常。

有关创建引用列表的信息,请参阅 «字典» 部分.

多个地理基

ClickHouse支持同时使用多个备选地理基(区域层次结构),以支持某些地区所属国家的各种观点。

该 ‘clickhouse-server’ config指定具有区域层次结构的文件::<path_to_regions_hierarchy_file>/opt/geo/regions_hierarchy.txt</path_to_regions_hierarchy_file>

除了这个文件,它还搜索附近有_符号和任何后缀附加到名称(文件扩展名之前)的文件。
例如,它还会找到该文件 /opt/geo/regions_hierarchy_ua.txt,如果存在。

ua 被称为字典键。 对于没有后缀的字典,键是空字符串。

所有字典都在运行时重新加载(每隔一定数量的秒重新加载一次,如builtin_dictionaries_reload_interval config参数中定义,或默认情况下每小时一次)。 但是,可用字典列表在服务器启动时定义一次。

所有处理区域的函数都在末尾有一个可选参数—字典键。它被称为地基。
示例:

  1. regionToCountry(RegionID) 使用默认路径: /opt/geo/regions_hierarchy.txt
  2. regionToCountry(RegionID, '') 使用默认路径: /opt/geo/regions_hierarchy.txt
  3. regionToCountry(RegionID, 'ua') 使用字典中的'ua' 键: /opt/geo/regions_hierarchy_ua.txt

regionToCity(id[, geobase])

从 Yandex geobase 接收一个 UInt32 数字类型的区域ID 。如果该区域是一个城市或城市的一部分,它将返回相应城市的区域ID。否则,返回0。

regionToArea(id[, geobase])

将区域转换为区域(地理数据库中的类型5)。 在所有其他方式,这个功能是一样的 ‘regionToCity’.

  1. SELECT DISTINCT regionToName(regionToArea(toUInt32(number), 'ua'))
  2. FROM system.numbers
  3. LIMIT 15
  1. ┌─regionToName(regionToArea(toUInt32(number), \'ua\'))─┐
  2. Moscow and Moscow region
  3. St. Petersburg and Leningrad region
  4. Belgorod region
  5. Ivanovsk region
  6. Kaluga region
  7. Kostroma region
  8. Kursk region
  9. Lipetsk region
  10. Orlov region
  11. Ryazan region
  12. Smolensk region
  13. Tambov region
  14. Tver region
  15. Tula region
  16. └──────────────────────────────────────────────────────┘

regionToDistrict(id[,geobase])

将区域转换为联邦区(地理数据库中的类型4)。 在所有其他方式,这个功能是一样的 ‘regionToCity’.

  1. SELECT DISTINCT regionToName(regionToDistrict(toUInt32(number), 'ua'))
  2. FROM system.numbers
  3. LIMIT 15
  1. ┌─regionToName(regionToDistrict(toUInt32(number), \'ua\'))─┐
  2. Central federal district
  3. Northwest federal district
  4. South federal district
  5. North Caucases federal district
  6. Privolga federal district
  7. Ural federal district
  8. Siberian federal district
  9. Far East federal district
  10. Scotland
  11. Faroe Islands
  12. Flemish region
  13. Brussels capital region
  14. Wallonia
  15. Federation of Bosnia and Herzegovina
  16. └──────────────────────────────────────────────────────────┘

regionToCountry(id[, geobase])

将区域转换为国家。 在所有其他方式,这个功能是一样的 ‘regionToCity’.
示例: regionToCountry(toUInt32(213)) = 225 转换莫斯科(213)到俄罗斯(225)。

regionToContinent(id[, geobase])

将区域转换为大陆。 在所有其他方式,这个功能是一样的 ‘regionToCity’.
示例: regionToContinent(toUInt32(213)) = 10001 将莫斯科(213)转换为欧亚大陆(10001)。

regionToTopContinent (#regiontotopcontinent)

查找该区域层次结构中最高的大陆。

语法

  1. regionToTopContinent(id[, geobase])

参数

返回值

  • 顶级大陆的标识符(当您在区域层次结构中攀爬时,是后者)。
  • 0,如果没有。

类型: UInt32.

regionToPopulation(id[, geobase])

获取区域的人口。
人口可以记录在文件与地球基。请参阅«外部词典»部分。
如果没有为该区域记录人口,则返回0。
在Yandex地理数据库中,可能会为子区域记录人口,但不会为父区域记录人口。

regionIn(lhs,rhs[,地理数据库])

检查是否 ‘lhs’ 属于一个区域 ‘rhs’ 区域。 如果属于UInt8,则返回等于1的数字,如果不属于则返回0。
这种关系是反射的——任何地区也属于自己。

regionHierarchy(id[, geobase])

从 Yandex geobase 接收一个 UInt32 数字类型的区域ID。返回一个区域ID数组,由传递的区域和链上的所有父节点组成。
示例: regionHierarchy(toUInt32(213)) = [213,1,3,225,10001,10000].

regionToName(id[, lang])

从 Yandex geobase 接收一个 UInt32 数字类型的区域ID。带有语言名称的字符串可以作为第二个参数传递。支持的语言有:ru, en, ua, uk, by, kz, tr。如果省略第二个参数,则使用’ ru ‘语言。如果不支持该语言,则抛出异常。返回一个字符串-对应语言的区域名称。如果指定ID的区域不存在,则返回一个空字符串。

uauk 都意味着乌克兰。