Skip to content

Commit 2439a68

Browse files
authored
Merge pull request ClickHouse#82542 from ClickHouse/Blargian-patch-16
Docs: embed videos on dictionaries in dictionaries page
2 parents db295a1 + 519be02 commit 2439a68

File tree

2 files changed

+11
-4
lines changed

2 files changed

+11
-4
lines changed

ci/jobs/scripts/check_style/aspell-ignore/en/aspell-dict.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1894,12 +1894,14 @@ geoToS
18941894
geobase
18951895
geobases
18961896
geocode
1897+
geocoding
18971898
geohash
18981899
geohashDecode
18991900
geohashEncode
19001901
geohashes
19011902
geohashesInBox
19021903
geoip
1904+
geolocation
19031905
geospatial
19041906
getClientHTTPHeader
19051907
getMacro

docs/en/sql-reference/dictionaries/index.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -800,7 +800,9 @@ This type of storage is for use with composite [keys](#dictionary-key-and-fields
800800

801801
### ip_trie {#ip_trie}
802802

803-
This type of storage is for mapping network prefixes (IP addresses) to metadata such as ASN.
803+
This dictionary is designed for IP address lookups by network prefix. It stores IP ranges in CIDR notation and allows fast determination of which prefix (e.g. subnet or ASN range) a given IP falls into, making it ideal for IP-based searches like geolocation or network classification.
804+
805+
<iframe width="1024" height="576" src="https://www.youtube.com/embed/4dxMAqltygk?si=rrQrneBReK6lLfza" title="IP based search with the ip_trie dictionary" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
804806

805807
**Example**
806808

@@ -2139,8 +2141,9 @@ For our example, the structure of dictionary can be the following:
21392141
21402142
## Polygon dictionaries {#polygon-dictionaries}
21412143
2142-
Polygon dictionaries allow you to efficiently search for the polygon containing specified points.
2143-
For example: defining a city area by geographical coordinates.
2144+
This dictionary is optimized for point-in-polygon queries, essentially “reverse geocoding” lookups. Given a coordinate (latitude/longitude), it efficiently finds which polygon/region (from a set of many polygons, such as country or region boundaries) contains that point. It’s well-suited for mapping location coordinates to their containing region.
2145+
2146+
<iframe width="1024" height="576" src="https://www.youtube.com/embed/FyRsriQp46E?si=Kf8CXoPKEpGQlC-Y" title="Polygon Dictionaries in ClickHouse" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
21442147
21452148
Example of a polygon dictionary configuration:
21462149
@@ -2270,7 +2273,9 @@ Result:
22702273
22712274
## Regular Expression Tree Dictionary {#regexp-tree-dictionary}
22722275
2273-
Regular expression tree dictionaries are a special type of dictionary which represent the mapping from key to attributes using a tree of regular expressions. There are some use cases, e.g. parsing of [user agent](https://en.wikipedia.org/wiki/User_agent) strings, which can be expressed elegantly with regexp tree dictionaries.
2276+
This dictionary lets you map keys to values based on hierarchical regular-expression patterns. It’s optimized for pattern-match lookups (e.g. classifying strings like user agent strings by matching regex patterns) rather than exact key matching.
2277+
2278+
<iframe width="1024" height="576" src="https://www.youtube.com/embed/ESlAhUJMoz8?si=sY2OVm-zcuxlDRaX" title="An intro to ClickHouse regex tree dictionaries" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
22742279
22752280
### Use Regular Expression Tree Dictionary in ClickHouse Open-Source {#use-regular-expression-tree-dictionary-in-clickhouse-open-source}
22762281

0 commit comments

Comments
 (0)