thevar1able/ClickHouse
1
0
Fork 0
mirror of https://github.com/ClickHouse/ClickHouse.git synced 2024-11-19 14:11:58 +00:00
Code Issues Packages Projects Releases Wiki Activity
4a24d4f3ad
ClickHouse/docs/ru/functions/url_functions.rst

120 lines
6.3 KiB
ReStructuredText
Raw Normal View History

Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Функции для работы с URL
------------------------
Все функции работают не по RFC - то есть, максимально упрощены ради производительности.
Функции, извлекающие часть URL-а.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Если в URL-е нет ничего похожего, то возвращается пустая строка.
protocol
""""""""
Возвращает протокол. Примеры: http, ftp, mailto, magnet...
domain
"""""""
Возвращает домен.
domainWithoutWWW
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает домен, удалив не более одного 'www.' с начала, если есть.
topLevelDomain
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает домен верхнего уровня. Пример: .ru.
firstSignificantSubdomain
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
"""""""""""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает "первый существенный поддомен". Это понятие является нестандартным и специфично для Яндекс.Метрики. Первый существенный поддомен - это домен второго уровня, если он не равен одному из com, net, org, co, или домен третьего уровня, иначе. Например, firstSignificantSubdomain('https://news.yandex.ru/') = 'yandex', firstSignificantSubdomain('https://news.yandex.com.tr/') = 'yandex'. Список "несущественных" доменов второго уровня и другие детали реализации могут изменяться в будущем.
cutToFirstSignificantSubdomain
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
""""""""""""""""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает часть домена, включающую поддомены верхнего уровня до "первого существенного поддомена" (см. выше).
Например, ``cutToFirstSignificantSubdomain('https://news.yandex.com.tr/') = 'yandex.com.tr'``.
path
""""
Возвращает путь. Пример: ``/top/news.html`` Путь не включает в себя query string.
pathFull
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
То же самое, но включая query string и fragment. Пример: /top/news.html?page=2#comments
queryString
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
"""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает query-string. Пример: page=1&lr=213. query-string не включает в себя начальный знак вопроса, а также # и всё, что после #.
fragment
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает fragment identifier. fragment не включает в себя начальный символ решётки.
queryStringAndFragment
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
""""""""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает query string и fragment identifier. Пример: страница=1#29390.
extractURLParameter(URL, name)
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
""""""""""""""""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает значение параметра name в URL, если такой есть; или пустую строку, иначе; если параметров с таким именем много - вернуть первый попавшийся. Функция работает при допущении, что имя параметра закодировано в URL в точности таким же образом, что и в переданном аргументе.
extractURLParameters(URL)
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
"""""""""""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает массив строк вида name=value, соответствующих параметрам URL. Значения никак не декодируются.
extractURLParameterNames(URL)
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
"""""""""""""""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает массив строк вида name, соответствующих именам параметров URL. Значения никак не декодируются.
URLHierarchy(URL)
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
"""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает массив, содержащий URL, обрезанный с конца по символам /, ? в пути и query-string. Подряд идущие символы-разделители считаются за один. Резка производится в позиции после всех подряд идущих символов-разделителей. Пример:
URLPathHierarchy(URL)
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
"""""""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
То же самое, но без протокола и хоста в результате. Элемент / (корень) не включается. Пример:
Функция используется для реализации древовидных отчётов по URL в Яндекс.Метрике.
::
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
URLPathHierarchy('https://example.com/browse/CONV-6788') =
[
'/browse/',
'/browse/CONV-6788'
]
decodeURLComponent(URL)
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
"""""""""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Возвращает декодированный URL.
Пример:
.. code-block:: sql
:) SELECT decodeURLComponent('http://127.0.0.1:8123/?query=SELECT%201%3B') AS DecodedURL;
┌─DecodedURL─────────────────────────────┐
│ http://127.0.0.1:8123/?query=SELECT 1; │
└────────────────────────────────────────┘
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
Функции, удаляющие часть из URL-а
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Если в URL-е нет ничего похожего, то URL остаётся без изменений.
cutWWW
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Удаляет не более одного 'www.' с начала домена URL-а, если есть.
cutQueryString
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Удаляет query string. Знак вопроса тоже удаляется.
cutFragment
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
"""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Удаляет fragment identifier. Символ решётки тоже удаляется.
cutQueryStringAndFragment
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
"""""""""""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Удаляет query string и fragment identifier. Знак вопроса и символ решётки тоже удаляются.
cutURLParameter(URL, name)
Fixed some ERRORS and WARNINGS during RU docs build. (#772) * Initial commit if EN docs * Part of EN documentation * Full queries section * External data * Table engines * System tables * Table functions * Formats * Data types * Operators * Functions * Dictionaries * Settings * Configuration files * Access rights * Quotas * Fixed few formatting errors * Fixed few formatting errors * Fixed few formatting errors * FIX: "WARNING: Title underline too short." during build RU docs. * FIX: "WARNING: Title underline too short." during build RU docs.
2017-05-08 05:06:04 +00:00
""""""""""""""""""""""""""
Added documentation in RST format. (ReadTheDocs ready)
2017-03-12 17:58:51 +00:00
Удаляет параметр URL с именем name, если такой есть. Функция работает при допущении, что имя параметра закодировано в URL в точности таким же образом, что и в переданном аргументе.
Reference in New Issue Copy Permalink