Merge branch 'main' of https://github.com/ClickHouse/clickhouse-docs into vertical_stepper_support_all

Author: Blargian

docs/getting-started/install/install.mdx

@@ -16,7 +16,7 @@ import MacOSProd from './_snippets/_macos.md'
 import Docker from './_snippets/_docker.md'
 import {CardPrimary} from '@clickhouse/click-ui/bundled';
 
-# Installation Instructions
+# Installation instructions
 
 <CardPrimary
     alignContent="center"

docs/integrations/data-ingestion/clickpipes/index.md

@@ -14,6 +14,7 @@ import S3svg from '@site/static/images/integrations/logos/amazon_s3_logo.svg';
 import Amazonkinesis from '@site/static/images/integrations/logos/amazon_kinesis_logo.svg';
 import Gcssvg from '@site/static/images/integrations/logos/gcs.svg';
 import DOsvg from '@site/static/images/integrations/logos/digitalocean.svg';
+import ABSsvg from '@site/static/images/integrations/logos/azureblobstorage.svg';
 import Postgressvg from '@site/static/images/integrations/logos/postgresql.svg';
 import Mysqlsvg from '@site/static/images/integrations/logos/mysql.svg';
 import redpanda_logo from '@site/static/images/integrations/logos/logo_redpanda.png';
@@ -42,7 +43,7 @@ import Image from '@theme/IdealImage';
 | Amazon S3            | <S3svg class="image" alt="Amazon S3 logo" style={{width: '3rem', height: 'auto'}}/>              |Object Storage| Stable           | Configure ClickPipes to ingest large volumes of data from object storage.                            |
 | Google Cloud Storage | <Gcssvg class="image" alt="Google Cloud Storage logo" style={{width: '3rem', height: 'auto'}}/>  |Object Storage| Stable           | Configure ClickPipes to ingest large volumes of data from object storage.                            |
 | DigitalOcean Spaces | <DOsvg class="image" alt="Digital Ocean logo" style={{width: '3rem', height: 'auto'}}/> | Object Storage | Stable | Configure ClickPipes to ingest large volumes of data from object storage.
-
+| Azure Blob Storage | <ABSsvg class="image" alt="Azure Blob Storage logo" style={{width: '3rem', height: 'auto'}}/> | Object Storage | Private Beta | Configure ClickPipes to ingest large volumes of data from object storage.
 | Amazon Kinesis       | <Amazonkinesis class="image" alt="Amazon Kenesis logo" style={{width: '3rem', height: 'auto'}}/> |Streaming| Stable           | Configure ClickPipes and start ingesting streaming data from Amazon Kinesis into ClickHouse cloud.   |
 | Postgres             | <Postgressvg class="image" alt="Postgres logo" style={{width: '3rem', height: 'auto'}}/>         |DBMS| Public Beta      | Configure ClickPipes and start ingesting data from Postgres into ClickHouse Cloud.                   |
 | MySQL                | <Mysqlsvg class="image" alt="MySQL logo" style={{width: '3rem', height: 'auto'}}/>               |DBMS| Private Beta | Configure ClickPipes and start ingesting data from MySQL into ClickHouse Cloud.                      |

docs/integrations/data-ingestion/clickpipes/object-storage.md

@@ -8,6 +8,7 @@ title: 'Integrating Object Storage with ClickHouse Cloud'
 import S3svg from '@site/static/images/integrations/logos/amazon_s3_logo.svg';
 import Gcssvg from '@site/static/images/integrations/logos/gcs.svg';
 import DOsvg from '@site/static/images/integrations/logos/digitalocean.svg';
+import ABSsvg from '@site/static/images/integrations/logos/azureblobstorage.svg';
 import cp_step0 from '@site/static/images/integrations/data-ingestion/clickpipes/cp_step0.png';
 import cp_step1 from '@site/static/images/integrations/data-ingestion/clickpipes/cp_step1.png';
 import cp_step2_object_storage from '@site/static/images/integrations/data-ingestion/clickpipes/cp_step2_object_storage.png';
@@ -23,7 +24,7 @@ import cp_overview from '@site/static/images/integrations/data-ingestion/clickpi
 import Image from '@theme/IdealImage';
 
 # Integrating Object Storage with ClickHouse Cloud
-Object Storage ClickPipes provide a simple and resilient way to ingest data from Amazon S3, Google Cloud Storage, and DigitalOcean Spaces into ClickHouse Cloud. Both one-time and continuous ingestion are supported with exactly-once semantics.
+Object Storage ClickPipes provide a simple and resilient way to ingest data from Amazon S3, Google Cloud Storage, Azure Blob Storage, and DigitalOcean Spaces into ClickHouse Cloud. Both one-time and continuous ingestion are supported with exactly-once semantics.
 
 
 ## Prerequisite {#prerequisite}
@@ -95,6 +96,7 @@ Image
 | Amazon S3            |<S3svg class="image" alt="Amazon S3 logo" style={{width: '3rem', height: 'auto'}}/>|Object Storage| Stable          | Configure ClickPipes to ingest large volumes of data from object storage.                            |
 | Google Cloud Storage |<Gcssvg class="image" alt="Google Cloud Storage logo" style={{width: '3rem', height: 'auto'}}/>|Object Storage| Stable          | Configure ClickPipes to ingest large volumes of data from object storage.                            |
 | DigitalOcean Spaces | <DOsvg class="image" alt="Digital Ocean logo" style={{width: '3rem', height: 'auto'}}/> | Object Storage | Stable | Configure ClickPipes to ingest large volumes of data from object storage.
+| Azure Blob Storage | <ABSsvg class="image" alt="Azure Blob Storage logo" style={{width: '3rem', height: 'auto'}}/> | Object Storage | Private Beta | Configure ClickPipes to ingest large volumes of data from object storage.
 
 More connectors will get added to ClickPipes, you can find out more by [contacting us](https://clickhouse.com/company/contact?loc=clickpipes).
 
@@ -126,13 +128,13 @@ To increase the throughput on large ingest jobs, we recommend scaling the ClickH
 - There are limitations on the types of views that are supported. Please read the section on [exactly-once semantics](#exactly-once-semantics) and [view support](#view-support) for more information.
 - Role authentication is not available for S3 ClickPipes for ClickHouse Cloud instances deployed into GCP or Azure. It is only supported for AWS ClickHouse Cloud instances.
 - ClickPipes will only attempt to ingest objects at 10GB or smaller in size. If a file is greater than 10GB an error will be appended to the ClickPipes dedicated error table.
-- S3 / GCS ClickPipes **does not** share a listing syntax with the [S3 Table Function](/sql-reference/table-functions/s3).
+- S3 / GCS ClickPipes **does not** share a listing syntax with the [S3 Table Function](/sql-reference/table-functions/s3), nor Azure with the [AzureBlobStorage Table function](/sql-reference/table-functions/azureBlobStorage).
   - `?` — Substitutes any single character
   - `*` — Substitutes any number of any characters except / including empty string
   - `**` — Substitutes any number of any character include / including empty string
 
 :::note
-This is a valid path:
+This is a valid path (for S3):
 
 https://datasets-documentation.s3.eu-west-3.amazonaws.com/http/**.ndjson.gz
 
@@ -143,7 +145,7 @@ https://datasets-documentation.s3.eu-west-3.amazonaws.com/http/{documents-01,doc
 :::
 
 ## Continuous Ingest {#continuous-ingest}
-ClickPipes supports continuous ingestion from S3, GCS, and DigitalOcean Spaces. When enabled, ClickPipes will continuously ingest data from the specified path, it will poll for new files at a rate of once every 30 seconds. However, new files must be lexically greater than the last ingested file, meaning they must be named in a way that defines the ingestion order. For instance, files named `file1`, `file2`, `file3`, etc., will be ingested sequentially. If a new file is added with a name like `file0`, ClickPipes will not ingest it because it is not lexically greater than the last ingested file.
+ClickPipes supports continuous ingestion from S3, GCS, Azure Blob Storage, and DigitalOcean Spaces. When enabled, ClickPipes continuously ingests data from the specified path, and polls for new files at a rate of once every 30 seconds. However, new files must be lexically greater than the last ingested file. This means that they must be named in a way that defines the ingestion order. For instance, files named `file1`, `file2`, `file3`, etc., will be ingested sequentially. If a new file is added with a name like `file0`, ClickPipes will not ingest it because it is not lexically greater than the last ingested file.
 
 ## Archive table {#archive-table}
 ClickPipes will create a table next to your destination table with the postfix `s3_clickpipe_<clickpipe_id>_archive`. This table will contain a list of all the files that have been ingested by the ClickPipe. This table is used to track files during ingestion and can be used to verify files have been ingested. The archive table has a [TTL](/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-ttl) of 7 days.
@@ -167,6 +169,8 @@ The Service Account permissions attached to the HMAC credentials should be `stor
 ### DigitalOcean Spaces {#dospaces}
 Currently only protected buckets are supported for DigitalOcean spaces. You require an "Access Key" and a "Secret Key" to access the bucket and its files. You can read [this guide](https://docs.digitalocean.com/products/spaces/how-to/manage-access/) on how to create access keys.
 
+### Azure Blob Storage {#azureblobstorage}
+Currently only protected buckets are supported for Azure Blob Storage. Authentication is done via a connection string, which supports access keys and shared keys. For more information, read [this guide](https://learn.microsoft.com/en-us/azure/storage/common/storage-configure-connection-string).
 
 ## F.A.Q. {#faq}
 

docusaurus.config.ru.js

@@ -3,6 +3,7 @@ import math from "remark-math";
 import katex from "rehype-katex";
 import chHeader from "./plugins/header.js";
 import fixLinks from "./src/hooks/fixLinks.js";
+const remarkCustomBlocks = require('./plugins/remark-custom-blocks');
 
 // Helper function to skip over index.md files.
 function skipIndex(items) {
@@ -128,7 +129,7 @@ const config = {
           showLastUpdateTime: false,
           sidebarCollapsed: true,
           routeBasePath: "/",
-          remarkPlugins: [math],
+          remarkPlugins: [math, remarkCustomBlocks],
           beforeDefaultRemarkPlugins: [fixLinks],
           rehypePlugins: [katex],
         },

i18n/ru/code.json

@@ -131,7 +131,7 @@
   },
   "theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": {
     "message": "← Перейти к главному меню",
-    "description": "The label of the back button to return to main menu, inside the mobile navbar sidebar (notably used to display the docs sidebar)"
+    "description": "The label of the back button to return to main menu, inside the mobile navbar sidebar secondary menu (notably used to display the docs sidebar)"
   },
   "theme.ErrorPageContent.title": {
     "message": "На странице произошёл сбой.",
@@ -868,5 +868,124 @@
   },
   "Report an issue": {
     "message": "Сообщите о проблеме"
+  },
+  "topNav.navItems.Products": {
+    "message": "Products"
+  },
+  "topNav.navItems.Use cases": {
+    "message": "Use cases"
+  },
+  "topNav.navItems.Docs": {
+    "message": "Docs"
+  },
+  "topNav.navItems.Resources": {
+    "message": "Resources"
+  },
+  "topNav.navItems.Pricing": {
+    "message": "Pricing"
+  },
+  "topNav.navItems.Contact us": {
+    "message": "Contact us"
+  },
+  "theme.IdealImageMessage.loading": {
+    "message": "Загрузка...",
+    "description": "When the full-scale image is loading"
+  },
+  "theme.IdealImageMessage.load": {
+    "message": "Нажмите для загрузки {sizeMessage}",
+    "description": "To prompt users to load the full image. sizeMessage is a parenthesized size figure."
+  },
+  "theme.IdealImageMessage.offline": {
+    "message": "Ваш браузер находится в автономном режиме. Изображение не загружено",
+    "description": "When the user is viewing an offline document"
+  },
+  "theme.IdealImageMessage.404error": {
+    "message": "404. Изображение не найдено",
+    "description": "When the image is not found"
+  },
+  "theme.IdealImageMessage.error": {
+    "message": "Ошибка. Нажмите для перезагрузки",
+    "description": "When the image fails to load for unknown error"
+  },
+  "topNav.navItems.products.clickhouse_cloud_1": {
+    "message": "The best way to use ClickHouse."
+  },
+  "topNav.navItems.products.clickhouse_cloud_2": {
+    "message": "Available on AWS, GCP, and Azure."
+  },
+  "topNav.navItems.products.byoc_1": {
+    "message": "Bring Your Own Cloud"
+  },
+  "topNav.navItems.products.byoc_2": {
+    "message": "A fully managed ClickHouse Cloud service,"
+  },
+  "topNav.navItems.products.byoc_3": {
+    "message": "deployed in your own AWS account."
+  },
+  "topNav.navItems.products.oss": {
+    "message": "Spin up a database with open-source"
+  },
+  "topNav.navItems.products.oss_2": {
+    "message": "ClickHouse"
+  },
+  "topNav.navItems.products.integrations": {
+    "message": "View 100+ integrations"
+  },
+  "topNav.navItems.resources.User stories": {
+    "message": "User stories"
+  },
+  "topNav.navItems.resources.Blog": {
+    "message": "Blog"
+  },
+  "topNav.navItems.resources.Learning and Certification": {
+    "message": "Learning and Certification"
+  },
+  "topNav.navItems.resources.ClickHouse Academy": {
+    "message": "ClickHouse Academy"
+  },
+  "topNav.navItems.resources.Free live training": {
+    "message": "Free live training"
+  },
+  "topNav.navItems.resources.ClickHouse Certification": {
+    "message": "ClickHouse Certification"
+  },
+  "topNav.navItems.resources.Comparisons": {
+    "message": "Comparisons"
+  },
+  "topNav.navItems.resources.BigQuery": {
+    "message": "BigQuery"
+  },
+  "topNav.navItems.resources.PostgreSQL": {
+    "message": "PostgreSQL"
+  },
+  "topNav.navItems.resources.Redshift": {
+    "message": "Redshift"
+  },
+  "topNav.navItems.resources.Rockset": {
+    "message": "Rockset"
+  },
+  "topNav.navItems.resources.Snowflake": {
+    "message": "Snowflake"
+  },
+  "topNav.navItems.resources.Videos": {
+    "message": "Videos"
+  },
+  "topNav.navItems.resources.Demos": {
+    "message": "Demos"
+  },
+  "topNav.navItems.use_cases.Real-time analytics": {
+    "message": "Real-time analytics"
+  },
+  "topNav.navItems.use_cases.Machine learning and GenAI": {
+    "message": "Machine learning and GenAI"
+  },
+  "topNav.navItems.use_cases.Business intelligence": {
+    "message": "Business intelligence"
+  },
+  "topNav.navItems.use_cases.Logs, events, and traces": {
+    "message": "Logs, events, and traces"
+  },
+  "topNav.navItems.use_cases.All use cases": {
+    "message": "All use cases"
   }
 }

i18n/ru/docusaurus-plugin-content-blog/options.json

@@ -11,4 +11,4 @@
     "message": "Все статьи базы знаний",
     "description": "The label for the left sidebar"
   }
-}
+}

i18n/ru/docusaurus-plugin-content-docs/current.json

@@ -413,7 +413,7 @@
   },
   "sidebar.managingData.doc.ReplacingMergeTree": {
     "message": "ReplacingMergeTree",
-    "description": "The label for the doc item ReplacingMergeTree in sidebar managingData, linking to the doc migrations/postgres/replacing-merge-tree"
+    "description": "The label for the doc item ReplacingMergeTree in sidebar managingData, linking to the doc guides/developer/replacing-merge-tree"
   },
   "sidebar.managingData.doc.Lightweight Deletes": {
     "message": "Легкое удаление",
@@ -685,7 +685,7 @@
   },
   "sidebar.dropdownCategories.link.Native Clients & Interfaces": {
     "message": "Нативные клиенты и интерфейсы",
-    "description": "The label for link Native Clients & Interfaces in sidebar dropdownCategories, linking to /interfaces/"
+    "description": "The label for link Native Clients & Interfaces in sidebar dropdownCategories, linking to /interfaces/natives-clients-and-interfaces"
   },
   "sidebar.dropdownCategories.link.Data Sources": {
     "message": "Источники данных",
@@ -730,5 +730,81 @@
   "sidebar.dropdownCategories.link.Development and Contributing": {
     "message": "Разработка и вклад",
     "description": "The label for link Development and Contributing in sidebar dropdownCategories, linking to /development/developer-instruction"
+  },
+  "sidebar.docs.category.Install": {
+    "message": "Установка",
+    "description": "The label for category Install in sidebar docs"
+  },
+  "sidebar.docs.category.Best Practices": {
+    "message": "Лучшие практики",
+    "description": "The label for category Best Practices in sidebar docs"
+  },
+  "sidebar.docs.category.Time-Series": {
+    "message": "временной ряд",
+    "description": "The label for category Time-Series in sidebar docs"
+  },
+  "sidebar.docs.category.Data lake": {
+    "message": "ДатаЛэйк",
+    "description": "The label for category Data lake in sidebar docs"
+  },
+  "sidebar.docs.doc.Overview": {
+    "message": "Обзор",
+    "description": "The label for the doc item Overview in sidebar docs, linking to the doc migrations/postgres/overview"
+  },
+  "sidebar.cloud.link.API Reference": {
+    "message": "Справочник по API",
+    "description": "The label for link API Reference in sidebar cloud, linking to https://clickhouse.com/docs/cloud/manage/api/swagger"
+  },
+  "sidebar.sqlreference.category.Специальные типы данных": {
+    "message": "Специальные типы данных",
+    "description": "The label for category Специальные типы данных in sidebar sqlreference"
+  },
+  "sidebar.sqlreference.category.Движки баз данных": {
+    "message": "Движки баз данных",
+    "description": "The label for category Движки баз данных in sidebar sqlreference"
+  },
+  "sidebar.sqlreference.category.Движки Таблиц": {
+    "message": "Движки Таблиц",
+    "description": "The label for category Движки Таблиц in sidebar sqlreference"
+  },
+  "sidebar.sqlreference.category.Семейство MergeTree": {
+    "message": "Семейство MergeTree",
+    "description": "The label for category Семейство MergeTree in sidebar sqlreference"
+  },
+  "sidebar.sqlreference.category.Семейство журналов": {
+    "message": "Семейство журналов",
+    "description": "The label for category Семейство журналов in sidebar sqlreference"
+  },
+  "sidebar.sqlreference.category.Интеграции": {
+    "message": "Интеграции",
+    "description": "The label for category Интеграции in sidebar sqlreference"
+  },
+  "sidebar.sqlreference.category.Специальные": {
+    "message": "Специальные",
+    "description": "The label for category Специальные in sidebar sqlreference"
+  },
+  "sidebar.sqlreference.category.Гео": {
+    "message": "Гео",
+    "description": "The label for category Гео in sidebar sqlreference"
+  },
+  "sidebar.sqlreference.category.Агрегатные функции": {
+    "message": "Агрегатные функции",
+    "description": "The label for category Агрегатные функции in sidebar sqlreference"
+  },
+  "sidebar.sqlreference.category.Combinator examples": {
+    "message": "Примеры комбинаторов",
+    "description": "The label for category Combinator examples in sidebar sqlreference"
+  },
+  "sidebar.integrations.category.Operations": {
+    "message": "Операции",
+    "description": "The label for category Operations in sidebar integrations"
+  },
+  "sidebar.integrations.category.ClickPipes for MySQL": {
+    "message": "ClickPipes для MySQL",
+    "description": "The label for category ClickPipes for MySQL in sidebar integrations"
+  },
+  "sidebar.integrations.category.Azure Data Factory": {
+    "message": "Azure Data Factory",
+    "description": "The label for category Azure Data Factory in sidebar integrations"
   }
 }

i18n/ru/docusaurus-plugin-content-docs/current/_snippets/_aws_regions.md

@@ -10,4 +10,3 @@
 |us-east-1 c1  | com.amazonaws.vpce.us-east-1.vpce-svc-096c118db1ff20ea4     | use1-az6 use1-az4 use1-az2   |
 |us-east-2     | com.amazonaws.vpce.us-east-2.vpce-svc-0b99748bf269a86b4     | use2-az1 use2-az2 use2-az3   |
 |us-west-2     | com.amazonaws.vpce.us-west-2.vpce-svc-049bbd33f61271781     | usw2-az2 usw2-az1 usw2-az3   |
-```