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

Author: Blargian

docs/about-us/adopters.md

@@ -69,7 +69,7 @@ The following list of companies using ClickHouse and their success stories is as
 | [Beeline](https://beeline.ru/)                                                                     | Telecom                                         | Data Platform                                               | [Blog post, July 2021](https://habr.com/en/company/beeline/blog/567508/)                                                                                                                                                                                                                                                                                                                                                                                                                                    | —                                                                                          | —                                                                  |
 | [Beekeeper](https://www.beekeeper.io/)                                                             | Workforce Enablement                            | Analytics                                                   | [Blog post, April 2024](https://www.meetup.com/clickhouse—switzerland—meetup—group/events/299628922)                                                                                                                                                                                                                                                                                                                                                                                                        | —                                                                                          | —                                                                  |
 | [Beetested](https://www.beetested.com/)                                                            | Software & Technology                           | Game Testing                                                | [Case Study, June 2023](https://double.cloud/resources/case—studies/beetested—analyze—millions—of—gamers—emotions—with—doublecloud/)                                                                                                                                                                                                                                                                                                                                                                        | —                                                                                          | —                                                                  |
-| [Benocs](https://www.benocs.com/)                                                                  | Network Telemetry and Analytics                 | Main Product                                                | [Meetup Video, December 2022](https://www.youtube.com/watch?v=48pAVShkeCY&list=PL0Z2YDlm0b3iNDUzpY1S3L_iV4nARda_U&index=12) [Slides, December 2022](https://github.com/ClickHouse/clickhouse—presentations/blob/master/meetup66/Self%20repairing%20processing%20using%20ClickHouse.pdf) [Blog Post, March 2022](https://clickhouse.com/blog/—indexing—for—data—streams—benocs—telco/) [Slides in English, October 2017](https://github.com/ClickHouse/clickhouse—presentations/blob/master/meetup9/lpm.pdf) | —                                                                                          | —                                                                  |
+| [Benocs](https://www.benocs.com/)                                                                  | Network Telemetry and Analytics                 | Main Product                                                | [Slides, December 2022](https://github.com/ClickHouse/clickhouse—presentations/blob/master/meetup66/Self%20repairing%20processing%20using%20ClickHouse.pdf) [Blog Post, March 2022](https://clickhouse.com/blog/—indexing—for—data—streams—benocs—telco/) [Slides in English, October 2017](https://github.com/ClickHouse/clickhouse—presentations/blob/master/meetup9/lpm.pdf) | —                                                                                          | —                                                                  |
 | [Bento](https://bento.me/en/home)                                                                  | Software & Technology                           | Personal Portfolio                                          | [Twitter, May 2023](https://twitter.com/gubmee/status/1653405962542219264)                                                                                                                                                                                                                                                                                                                                                                                                                                  | —                                                                                          | —                                                                  |
 | [Better Stack](https://betterstack.com/)                                                           | Cloud, SaaS                                     | Log Management                                              | [Official Website](https://betterstack.com/logtail)                                                                                                                                                                                                                                                                                                                                                                                                                                                         | —                                                                                          | —                                                                  |
 | [BiliBili](https://www.bilibili.com/)                                                              | Video sharing                                   | —                                                           | [Blog post, June 2021](https://chowdera.com/2021/06/20210622012241476b.html)                                                                                                                                                                                                                                                                                                                                                                                                                                | —                                                                                          | —                                                                  |

docs/cloud/manage/jan2025_faq/plan_migrations.md

@@ -70,7 +70,7 @@ Your service has to be on version 24.8 or later and already migrated to SharedMe
 
 ### What is the migration experience for users of the current Development and Production services? Do users need to plan for a maintenance window where the service is unavailable? {#what-is-the-migration-experience-for-users-of-the-current-development-and-production-services-do-users-need-to-plan-for-a-maintenance-window-where-the-service-is-unavailable}
 
-Migrations of Development and Production services to the new pricing tiers may trigger a server restart. To migrate a Dedicated service, please contact [support](https://clickhouse.com/support/program).
+Migrations of Development and Production services to the new pricing tiers may trigger a rolling restart. To migrate a Dedicated service, please contact [support](https://clickhouse.com/support/program).
 
 ### What other actions should a user take after the migration? {#what-other-actions-should-a-user-take-after-the-migration}
 

docs/cloud/reference/byoc.md

@@ -422,3 +422,9 @@ scrape_configs:
 ```
 
 Please also see [this blog post](https://clickhouse.com/blog/clickhouse-cloud-now-supports-prometheus-monitoring) and the [Prometheus setup docs for ClickHouse](/integrations/prometheus).
+
+### Uptime SLAs {#uptime-sla}
+
+#### Does ClickHouse offer an uptime SLA for BYOC? {#uptime-sla-for-byoc}
+
+No, since the data plane is hosted in the customer's cloud environment, service availability depends on resources not in ClickHouse's control. Therefore, ClickHouse does not offer a formal uptime SLA for BYOC deployments. If you have additional questions, please contact [email protected].

docs/cloud/reference/changelog.md

@@ -27,9 +27,35 @@ import kafka_config from '@site/static/images/cloud/reference/june-13-kafka-conf
 import fast_releases from '@site/static/images/cloud/reference/june-13-fast-releases.png';
 import share_queries from '@site/static/images/cloud/reference/may-30-share-queries.png';
 import query_endpoints from '@site/static/images/cloud/reference/may-17-query-endpoints.png';
+import dashboards from '@site/static/images/cloud/reference/may-30-dashboards.png';
 
 In addition to this ClickHouse Cloud changelog, please see the [Cloud Compatibility](/cloud/reference/cloud-compatibility.md) page.
 
+## May 30, 2025 {#may-30-2025}
+
+- We’re excited to announce general availability of **ClickPipes for Postgres CDC **
+  in ClickHouse Cloud. With just a few clicks, you can now replicate your Postgres
+  databases and unlock blazing-fast, real-time analytics. The connector delivers 
+  faster data synchronization, latency as low as a few seconds, automatic schema changes,
+  fully secure connectivity, and more. Refer to the 
+  [blog](https://clickhouse.com/blog/postgres-cdc-connector-clickpipes-ga) for 
+  more information. To get started, refer to the instructions [here](https://clickhouse.com/docs/integrations/clickpipes/postgres).
+
+- Introduced new improvements to the SQL console dashboards:
+  - Sharing: You can share your dashboard with your team members. Four levels of access are supported, that can be adjusted both globally and on a per-user basis:
+    - _Write access_: Add/edit visualizations, refresh settings, interact with dashboards via filters.
+    - _Owner_: Share a dashboard, delete a dashboard, and all other permissions of a user with "write access".
+    - _Read-only access_: View and interact with dashboard via filters
+    - _No access_: Cannot view a dashboard
+  - For existing dashboards that have already been created, Organization Administrators can assign existing dashboards to themselves as owners.
+  - You can now add a table or chart from the SQL console to a dashboard from the query view.
+
+<Image img={dashboards} size="md" alt="Dashboards improvements" border />
+
+
+- We are enlisting preview participants for [Distributed cache](https://clickhouse.com/cloud/distributed-cache-waitlist) 
+  for AWS and GCP. Read more in the [blog](https://clickhouse.com/blog/building-a-distributed-cache-for-s3).
+
 ## May 16, 2025 {#may-16-2025}
 
 - Introduced the Resource Utilization Dashboard which provides a view of 

docs/cloud/security/connectivity-overview.md

@@ -10,7 +10,7 @@ This section looks at connectivity and contains the following pages:
 
 | Page                                                                 | Description                                                                                                                   |
 |----------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------|
-| [Setting IP Filters](/cloud/security/setting-ip-filters)     | A guide on how to control traffic to your ClickHouse services using IP access lists.                                          |
+| [Setting IP Filters](/cloud/security/setting-ip-filters)     | A guide on how to control traffic to your ClickHouse services and API keys using IP access lists.                                          |
 | [Private Networking](/cloud/security/private-link-overview)  | Information on how to connect your services to your cloud virtual network.                                                    |
 | [Accessing S3 Data Securely](/cloud/security/secure-s3)      | A guide on how to leverage role-based access to authenticate with Amazon Simple Storage Service(S3) and access data securely. |
 | [Cloud IP Addresses](/manage/security/cloud-endpoints-api)   | Tables listing the static IPs and S3 endpoints for each supported cloud and region in ClickHouse Cloud.                       |

docs/cloud/security/setting-ip-filters.md

@@ -11,29 +11,48 @@ import ip_filter_add_single_ip from '@site/static/images/cloud/security/ip-filte
 
 ## Setting IP Filters {#setting-ip-filters}
 
-IP access lists filter traffic to your ClickHouse services by specifying which source addresses are permitted to connect to your ClickHouse service.  The lists are configurable for each service.  Lists can be configured during the deployment of a service, or afterward.  If you do not configure an IP access list during provisioning, or if you want to make changes to your initial list, then you can make those changes by selecting the service and then the **Security** tab.
+IP access lists filter traffic to ClickHouse services or API keys by specifying which source addresses are permitted to connect.  These lists are configurable for each service and each API key.  Lists can be configured during service or API key creation, or afterward.
 
 :::important
-If you skip the creation of the IP Access List for a ClickHouse Cloud service then no traffic will be permitted to the service.
+If you skip the creation of the IP access list for a ClickHouse Cloud service then no traffic will be permitted to the service.
 :::
 
 ## Prepare {#prepare}
-Before you begin, collect the IP Addresses or ranges that should be added to the access list.  Take into consideration remote workers, on-call locations, VPNs, etc. The IP Access List user interface accepts individual addresses and CIDR notation.
-
-Classless Inter-domain Routing (CIDR) notation, allows you to specify IP Address ranges smaller than the traditional Class A, B, or C (8, 6, or 24) subnet mask sizes. [ARIN](https://account.arin.net/public/cidrCalculator) and several other organizations provide CIDR calculators if you need one, and if you would like more information on CIDR notation, please see the [Classless Inter-domain Routing (CIDR)](https://www.rfc-editor.org/rfc/rfc4632.html) RFC.
-
-## Create or modify an IP Access List {#create-or-modify-an-ip-access-list}
-
-From your ClickHouse Cloud services list select the service and then select **Settings**.  Under the **Security** section, you will find the IP access list. Click on the hyperlink where the text says: *You can connect to this service from* **(anywhere | x specific locations)**
-
-A sidebar will appear with options for you to configure:
-
-- Allow incoming traffic from anywhere to the service
-- Allow access from specific locations to the service
-- Deny all access to the service
-
-This screenshot shows an access list which allows traffic from a range of IP Addresses, described as "NY Office range":
-
+Before you begin, collect the IP addresses or ranges that should be added to the access list.  Take into consideration remote workers, on-call locations, VPNs, etc. The IP access list user interface accepts individual addresses and CIDR notation.
+
+Classless Inter-domain Routing (CIDR) notation, allows you to specify IP address ranges smaller than the traditional Class A, B, or C (8, 6, or 24) subnet mask sizes. [ARIN](https://account.arin.net/public/cidrCalculator) and several other organizations provide CIDR calculators if you need one, and if you would like more information on CIDR notation, please see the [Classless Inter-domain Routing (CIDR)](https://www.rfc-editor.org/rfc/rfc4632.html) RFC.
+
+## Create or modify an IP access list {#create-or-modify-an-ip-access-list}
+
+<details>
+  <summary>IP access list for ClickHouse services</summary>
+
+  When you create a ClickHouse service, the default setting for the IP allow list is 'Allow from nowhere.' 
+  
+  From your ClickHouse Cloud services list select the service and then select **Settings**.  Under the **Security** section, you will find the IP access list. Click on the Add IPs button.
+  
+  A sidebar will appear with options for you to configure:
+  
+  - Allow incoming traffic from anywhere to the service
+  - Allow access from specific locations to the service
+  - Deny all access to the service
+  
+</details>
+<details>
+  <summary>IP access list for API keys</summary>
+
+  When you create an API key, the default setting for the IP allow list is 'Allow from anywhere.'
+  
+  From the API key list, click the three dots next to the API key under the **Actions** column and select **Edit**. At the bottom of the screen you will find the IP access list and options to configure:
+
+  - Allow incoming traffic from anywhere to the service
+  - Allow access from specific locations to the service
+  - Deny all access to the service
+  
+</details>
+
+This screenshot shows an access list which allows traffic from a range of IP addresses, described as "NY Office range":
+  
 <Image img={ip_filtering_after_provisioning} size="md" alt="Existing access list in ClickHouse Cloud" border/>
 
 ### Possible actions {#possible-actions}
@@ -60,7 +79,7 @@ To apply the changes you made, you must click **Save**.
 
 ## Verification {#verification}
 
-Once you create your filter confirm connectivity from within the range, and confirm that connections from outside the permitted range are denied.  A simple `curl` command can be used to verify:
+Once you create your filter confirm connectivity to a service from within the range, and confirm that connections from outside the permitted range are denied.  A simple `curl` command can be used to verify:
 ```bash title="Attempt rejected from outside the allow list"
 curl https://<HOSTNAME>.clickhouse.cloud:8443
 ```
@@ -81,4 +100,4 @@ Ok.
 
 ## Limitations {#limitations}
 
-- Currently, IP Access Lists support only IPv4
+- Currently, IP access lists support only IPv4

docs/getting-started/example-datasets/recipes.md

@@ -187,7 +187,7 @@ Result:
 10 rows in set. Elapsed: 0.215 sec. Processed 2.23 million rows, 1.48 GB (10.35 million rows/s., 6.86 GB/s.)
 ```
 
-In this example, we involve [has](../../sql-reference/functions/array-functions.md#hasarr-elem) function to filter by array elements and sort by the number of directions.
+In this example, we involve [has](../../sql-reference/functions/array-functions.md#has) function to filter by array elements and sort by the number of directions.
 
 There is a wedding cake that requires the whole 126 steps to produce! Show that directions: