Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
The diff you're trying to view is too large. We only load the first 3000 changed files.
2 changes: 1 addition & 1 deletion i18n/zh/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,4 @@

Modify this date to initiate rebuild:

`Wed 11 Jun 2025 11:23 GMT`
Last retranslated: `Tues 7 October 2025 11:54 GMT`
Original file line number Diff line number Diff line change
@@ -1,6 +1 @@
---
null
...
---

目录用于复制 Golang 源代码示例
<Content/>
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
---
'sidebar_label': '邀请'
'title': '邀请'
'doc_type': 'reference'
---

## List all invitations {#list-all-invitations}
## 列出所有邀请 {#list-all-invitations}

此文件是由 `clickhouseapi.js` 在构建过程中生成的。如果内容需要更改,请编辑 `clickhouseapi.js`。
此文件由 `clickhouseapi.js` 在构建过程中生成。如果需要更改内容,请编辑 `clickhouseapi.js`。
Original file line number Diff line number Diff line change
@@ -1 +1 @@
e0a35465deb99d56
ae39a53b276a84a9
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
---
'sidebar_label': '主键'
'title': '主键'
'doc_type': 'reference'
---

## 获取所有密钥的列表 {#get-list-of-all-keys}

此文件是由 `clickhouseapi.js` 在构建过程中生成的。如果需要更改内容,请编辑 `clickhouseapi.js`。
此文件由 `clickhouseapi.js` 在构建过程中生成。如果需要更改内容,请编辑 `clickhouseapi.js`。
Original file line number Diff line number Diff line change
@@ -1 +1 @@
7be3bf52f87fcb23
a304f0bb1aef8a9d
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
---
'sidebar_label': '成员'
'title': '成员'
'doc_type': 'reference'
---

## List organization members {#list-organization-members}
## 列出组织成员 {#list-organization-members}

此文件由 `clickhouseapi.js` 在构建过程中生成。如果内容需要更改,请编辑 `clickhouseapi.js`。
此文件由 `clickhouseapi.js` 在构建过程中生成。 如果需要更改内容,请编辑 `clickhouseapi.js`。
Original file line number Diff line number Diff line change
@@ -1 +1 @@
8ba59ed8d689efc4
620b28a4d887aad4
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
---
'sidebar_label': '组织'
'title': '组织'
'doc_type': 'reference'
---

## 获取组织详情 {#get-organization-details}
## 获取组织详细信息 {#get-organization-details}

此文件由 `clickhouseapi.js` 在构建过程中生成。如果需要更改内容,请编辑 `clickhouseapi.js`。
此文件是由 `clickhouseapi.js` 在构建过程中生成的。如果内容需要更改,请编辑 `clickhouseapi.js`。
Original file line number Diff line number Diff line change
@@ -1 +1 @@
43d9a3a08ee303a2
8b2e038d00786985
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
---
'sidebar_label': '服务'
'title': '服务'
'doc_type': 'landing-page'
---

## 组织服务列表 {#list-of-organization-services}

此文件由 `clickhouseapi.js` 在构建过程中生成。如果需要更改内容,请编辑 `clickhouseapi.js`。
此文件是在构建过程中由 `clickhouseapi.js` 生成的。 如果需要更改内容,请编辑 `clickhouseapi.js`。
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0bf9371323aac313
0791a0cd491a5639
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
---
'description': '2025 年的更新日志'
'description': '2025 的更新日志'
'note': 'This file is autogenerated by the yarn new-build'
'slug': '/whats-new/changelog/'
'sidebar_position': 2
'sidebar_label': '2025'
'title': '2025 更新日志'
'doc_type': 'changelog'
---

<Content/>
Original file line number Diff line number Diff line change
@@ -1 +1 @@
cff204a8b011fa88
942656fa7dd0e1fc
Original file line number Diff line number Diff line change
@@ -1,8 +1,3 @@
---
null
...
---

import GCS_bucket_1 from '@site/static/images/integrations/data-ingestion/s3/GCS-bucket-1.png';
import GCS_bucket_2 from '@site/static/images/integrations/data-ingestion/s3/GCS-bucket-2.png';
import GCS_create_service_account_key from '@site/static/images/integrations/data-ingestion/s3/GCS-create-a-service-account-key.png';
Expand All @@ -26,32 +21,32 @@ import Image from '@theme/IdealImage';

### 生成访问密钥 {#generate-an-access-key}

### 创建服务账户 HMAC 密钥和秘密 {#create-a-service-account-hmac-key-and-secret}
### 创建服务账号 HMAC 密钥和秘密 {#create-a-service-account-hmac-key-and-secret}

打开 **Cloud Storage > 设置 > 互操作性**,然后选择一个现有的 **访问密钥**,或者 **为服务账户创建密钥**。 本指南涵盖了为新服务账户创建新密钥的步骤
打开 **Cloud Storage > 设置 > 互操作性**,然后选择现有的 **访问密钥**,或者 **为服务账号创建密钥**。本指南涵盖为新服务账号创建新密钥的路径

<Image size="md" img={GCS_create_service_account_key} alt="在 GCS 中生成服务账户 HMAC 密钥" border />
<Image size="md" img={GCS_create_service_account_key} alt="在 GCS 中生成服务账号 HMAC 密钥" border />

### 添加新服务账户 {#add-a-new-service-account}
### 添加新服务账号 {#add-a-new-service-account}

如果这是一个没有现有服务账户的项目,请 **创建新账户**。
如果这是一个没有现有服务账号的项目,请 **创建新账号**。

<Image size="md" img={GCS_create_service_account_0} alt="在 GCS 中添加新服务账户" border />
<Image size="md" img={GCS_create_service_account_0} alt="在 GCS 中添加新服务账号" border />

创建服务账户的步骤有三步,第一步给账户一个有意义的名称、ID 和描述。
创建服务账号有三个步骤。在第一步中,给账号一个有意义的名称、ID 和描述。

<Image size="md" img={GCS_create_service_account_a} alt="在 GCS 中定义新服务账户的名称和 ID" border />
<Image size="md" img={GCS_create_service_account_a} alt="在 GCS 中定义新服务账号名称和 ID" border />

在互操作性设置对话框中,推荐选择 IAM 角色 **Storage Object Admin**;在第二步中选择该角色。
在互操作性设置对话框中,推荐 IAM 角色 **存储对象管理员** 角色;在第二步中选择该角色。

<Image size="md" img={GCS_create_service_account_2} alt="在 GCS 中选择 IAM 角色 Storage Object Admin" border />
<Image size="md" img={GCS_create_service_account_2} alt="在 GCS 中选择 IAM 角色存储对象管理员" border />

第三步是可选的,在本指南中未使用。 您可以根据政策允许用户拥有这些权限
第三步是可选的,本指南中未使用。您可以根据您的策略允许用户具有这些权限

<Image size="md" img={GCS_create_service_account_3} alt="为新服务账户配置额外设置的 GCS" border />
<Image size="md" img={GCS_create_service_account_3} alt=" GCS 中配置新服务账号的附加设置" border />

服务账户 HMAC 密钥将被显示。 请保存该信息,因为它将在 ClickHouse 配置中使用。
服务账号 HMAC 密钥将会显示。请保存这些信息,因为它将在 ClickHouse 配置中使用。

<Image size="md" img={GCS_guide_key} alt="检索到生成的 GCS HMAC 密钥" border />
<Image size="md" img={GCS_guide_key} alt="检索生成的 GCS HMAC 密钥" border />

</details>
Original file line number Diff line number Diff line change
@@ -1 +1 @@
e28c24c6b6f89390
003df1f3c664139d
Original file line number Diff line number Diff line change
@@ -1,8 +1,3 @@
---
null
...
---

import Image from '@theme/IdealImage';
import s3_1 from '@site/static/images/_snippets/s3/s3-1.png';
import s3_2 from '@site/static/images/_snippets/s3/s3-2.png';
Expand All @@ -25,44 +20,44 @@ import s3_h from '@site/static/images/_snippets/s3/s3-h.png';
<details>
<summary>创建 S3 桶和 IAM 用户</summary>

本文演示了如何配置 AWS IAM 用户、创建 S3 桶并配置 ClickHouse 使用该桶作为 S3 磁盘的基本知识。您应该与您的安全团队合作,以确定要使用的权限,并将其视为起点。
本文演示了如何配置 AWS IAM 用户、创建 S3 桶并配置 ClickHouse 使用该桶作为 S3 磁盘的基础知识。您应与安全团队合作,以确定要使用的权限,并将其视为起点。

### 创建 AWS IAM 用户 {#create-an-aws-iam-user}
在此过程中,我们将创建一个服务账户用户,而不是登录用户。
1. 登录到 AWS IAM 管理控制台。
1. 登录 AWS IAM 管理控制台。

2. 在“用户”中,选择 **添加用户**

<Image size="md" img={s3_1} alt="AWS IAM 管理控制台 - 添加新用户" border force/>

3. 输入用户名并将凭证类型设置为 **访问密钥 - 编程访问**,然后选择 **下一步:权限**
3. 输入用户名,并将凭证类型设置为 **访问密钥 - 程序访问**,然后选择 **下一步:权限**

<Image size="md" img={s3_2} alt=" IAM 用户设置用户名和访问类型" border force/>
<Image size="md" img={s3_2} alt="设置 IAM 用户的用户名和访问类型" border force/>

4. 不要将用户添加到任何组中;选择 **下一步:标签**
4. 不要将用户添加到任何组;选择 **下一步:标签**

<Image size="md" img={s3_3} alt="跳过对 IAM 用户的组分配" border force/>
<Image size="md" img={s3_3} alt="跳过 IAM 用户的组分配" border force/>

5. 除非您需要添加任何标签,否则选择 **下一步:审核**
5. 除非需要添加任何标签,否则选择 **下一步:审核**

<Image size="md" img={s3_4} alt="跳过对 IAM 用户的标签分配" border force/>
<Image size="md" img={s3_4} alt="跳过 IAM 用户的标签分配" border force/>

6. 选择 **创建用户**

:::note
提示信息称用户没有权限可以忽略;用户在下一节将获得桶的权限
表示用户没有权限的警告可以忽略;将在下一部分中授予用户对桶的权限。
:::

<Image size="md" img={s3_5} alt="创建 IAM 用户时不带权限的警告" border force/>
<Image size="md" img={s3_5} alt="创建 IAM 用户时没有权限警告" border force/>

7. 用户现在已创建;单击 **显示** 并复制访问密钥和秘密密钥。
7. 用户现在已创建;点击 **显示** 并复制访问密钥和秘密密钥。
:::note
请将密钥保存在其他地方;这是唯一一次可以使用的秘密访问密钥
请将密钥保存到其他地方;这是唯一能获取秘密访问密钥的时间
:::

<Image size="md" img={s3_6} alt="查看和复制 IAM 用户访问密钥" border force/>
<Image size="md" img={s3_6} alt="查看并复制 IAM 用户访问密钥" border force/>

8. 单击关闭,然后在用户屏幕中找到该用户
8. 点击关闭,然后在用户列表中找到用户

<Image size="md" img={s3_7} alt="在用户列表中找到新创建的 IAM 用户" border force/>

Expand All @@ -73,47 +68,47 @@ import s3_h from '@site/static/images/_snippets/s3/s3-h.png';
### 创建 S3 桶 {#create-an-s3-bucket}
1. 在 S3 桶部分,选择 **创建桶**

<Image size="md" img={s3_9} alt="开始 S3 桶创建过程" border force/>
<Image size="md" img={s3_9} alt="开始创建 S3 桶的过程" border force/>

2. 输入桶名称,保持其他选项为默认值
2. 输入桶名称,其他选项保持默认
:::note
桶名称在 AWS 中必须是唯一的,而不仅仅是在组织中,否则将发出错误。
桶名称必须在 AWS 中唯一,而不仅仅是在组织内部,否则将发出错误。
:::
3. 保持 `阻止所有公共访问` 启用;不需要公共访问。
3. 保留 `阻止所有公共访问` 启用;不需要公共访问。

<Image size="md" img={s3_a} alt="配置公共访问被阻止的 S3 桶设置" border force/>
<Image size="md" img={s3_a} alt="配置 S3 桶设置,阻止公共访问" border force/>

4. 选择页面底部的 **创建桶**
4. 在页面底部选择 **创建桶**

<Image size="md" img={s3_b} alt="最终确定 S3 桶创建过程" border force/>
<Image size="md" img={s3_b} alt="完成 S3 桶的创建" border force/>

5. 选择链接,复制 ARN,并保存以供在配置桶的访问策略时使用
5. 选择链接,复制 ARN,并保存以便在配置桶的访问策略时使用

6. 一旦桶创建完成,在 S3 桶列表中找到新创建的 S3 桶,并选择链接
6. 创建桶后,在 S3 桶列表中找到新创建的 S3 桶并选择链接

<Image size="md" img={s3_c} alt="在桶列表中找到新创建的 S3 桶" border force/>

7. 选择 **创建文件夹**

<Image size="md" img={s3_d} alt="在 S3 桶中创建新文件夹" border force/>

8. 输入一个文件夹名称,该名称将作为 ClickHouse S3 磁盘的目标,然后选择 **创建文件夹**
8. 输入一个文件夹名称,作为 ClickHouse S3 磁盘的目标,并选择 **创建文件夹**

<Image size="md" img={s3_e} alt="设置 ClickHouse S3 磁盘使用的文件夹名称" border force/>
<Image size="md" img={s3_e} alt=" ClickHouse S3 磁盘使用设置文件夹名称" border force/>

9. 该文件夹现在应在桶列表中可见
9. 该文件夹现在应该在桶列表中可见

<Image size="md" img={s3_f} alt="查看新创建的 S3 桶中的文件夹" border force/>
<Image size="md" img={s3_f} alt="查看新创建的文件夹在 S3 桶中的情况" border force/>

10. 选择新文件夹的复选框,然后单击 **复制 URL**保存复制的 URL,以便在下一节的 ClickHouse 存储配置中使用。
10. 选择新文件夹的复选框并点击 **复制 URL** 保存复制的 URL,以便在下一节的 ClickHouse 存储配置中使用。

<Image size="md" img={s3_g} alt="复制用于 ClickHouse 配置的 S3 文件夹 URL" border force/>
<Image size="md" img={s3_g} alt="复制 S3 文件夹 URL 用于 ClickHouse 配置" border force/>

11. 选择 **权限** 选项卡,然后在 **桶策略** 部分单击 **编辑** 按钮
11. 选择 **权限** 选项卡,然后在 **桶策略** 部分点击 **编辑** 按钮

<Image size="md" img={s3_h} alt="访问 S3 桶策略配置" border force/>

12. 添加桶策略,如下面示例所示
12. 添加桶策略,示例如下
```json
{
"Version" : "2012-10-17",
Expand Down Expand Up @@ -147,8 +142,8 @@ import s3_h from '@site/static/images/_snippets/s3/s3-h.png';
```

:::note
您应该与您的安全团队合作,以确定要使用的权限,并将其视为起点
有关策略和设置的更多信息,请参考 AWS 文档:
您应与安全团队合作,以确定要使用的权限,将这些视为起点
有关策略和设置的更多信息,请参阅 AWS 文档:
https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-policy-language-overview.html
:::

Expand Down
Original file line number Diff line number Diff line change
@@ -1,21 +1,16 @@
---
null
...
---

import Image from '@theme/IdealImage';
import ip_allow_list_check_list from '@site/static/images/_snippets/ip-allow-list-check-list.png';
import ip_allow_list_add_current_ip from '@site/static/images/_snippets/ip-allow-list-add-current-ip.png';

<details>
<summary>管理您的 IP 访问列表</summary>

从您的 ClickHouse Cloud 服务列表中选择您将要使用的服务,并切换到 **设置**。如果 IP 访问列表中不包含需要连接到您的 ClickHouse Cloud 服务的远程系统的 IP 地址或范围,则可以通过 **添加 IP** 来解决此问题:
从您的 ClickHouse Cloud 服务列表中选择您要使用的服务,并切换到 **设置**。如果 IP 访问列表中不包含需要连接到您的 ClickHouse Cloud 服务的远程系统的 IP 地址或范围,您可以通过 **添加 IP** 来解决此问题:

<Image size="md" img={ip_allow_list_check_list} alt="检查服务是否允许来自您的 IP 地址的流量在 IP 访问列表中" border />

添加需要连接到您的 ClickHouse Cloud 服务的单个 IP 地址或地址范围。根据需要修改表单,然后 **保存**。

<Image size="md" img={ip_allow_list_add_current_ip} alt="将您当前的 IP 地址添加到 ClickHouse Cloud 中的 IP 访问列表" border />
<Image size="md" img={ip_allow_list_add_current_ip} alt="将您的当前 IP 地址添加到 ClickHouse Cloud IP 访问列表中" border />

</details>
Original file line number Diff line number Diff line change
@@ -1,46 +1,41 @@
---
null
...
---

<details>
<summary>在 Docker 中启动 Apache Superset</summary>

Superset 提供了 [使用 Docker Compose 本地安装 Superset](https://superset.apache.org/docs/installation/installing-superset-using-docker-compose/) 的说明。在从 GitHub 上检出 Apache Superset 仓库后,您可以运行最新的开发代码或特定标签。我们推荐使用 2.0.0 版本,因为它是最新的未标记为 `pre-release` 的版本
Superset 提供了 [使用 Docker Compose 安装 Superset](https://superset.apache.org/docs/installation/installing-superset-using-docker-compose/) 的说明。在从 GitHub 检出 Apache Superset 仓库后,您可以运行最新的开发代码或特定的标签。我们推荐使用 2.0.0 版本,因为它是最新的未标记为 `pre-release` 的发布版本

在运行 `docker compose` 之前,有几个任务需要完成
在运行 `docker compose` 之前需要完成几个任务

1. 添加官方 ClickHouse Connect 驱动程序
2. 获取一个 Mapbox API 密钥并将其添加为环境变量(可选)
1. 添加官方的 ClickHouse Connect 驱动
2. 获取 Mapbox API 密钥并将其添加为环境变量(可选)
3. 指定要运行的 Superset 版本

:::tip
以下命令需从 GitHub 仓库的顶层目录 `superset` 中运行。
以下命令需在 GitHub 仓库的顶层目录 `superset` 中运行。
:::

## 官方 ClickHouse Connect 驱动程序 {#official-clickhouse-connect-driver}
## 官方 ClickHouse Connect 驱动 {#official-clickhouse-connect-driver}

要使 ClickHouse Connect 驱动程序在 Superset 部署中可用,请将其添加到本地需求文件中:
为了在 Superset 部署中使用 ClickHouse Connect 驱动,请将其添加到本地需求文件中:

```bash
echo "clickhouse-connect" >> ./docker/requirements-local.txt
```

## Mapbox {#mapbox}

这是可选的,您可以在 Superset 中绘制位置数据,而无需 Mapbox API 密钥,但您会看到一条消息,提示您应添加密钥,并且地图的背景图像将缺失(您只会看到数据点,而没有地图背景)。如果您想使用它,Mapbox 提供免费层
这是可选的,您可以在 Superset 中绘制位置数据而不需要 Mapbox API 密钥,但您会看到一条消息提示您应该添加一个密钥,并且地图的背景图像将会缺失(您只会看到数据点,而看不到地图背景)。如果您想使用 Mapbox,它提供了免费使用层

一些示例可视化指南要求您创建使用位置(例如经度和纬度)数据的可视化。Superset 包含对 Mapbox 地图的支持。要使用 Mapbox 可视化,您需要一个 Mapbox API 密钥。注册 [Mapbox 免费层](https://account.mapbox.com/auth/signup/),并生成一个 API 密钥。
一些指南中让您创建的示例可视化使用了位置数据,例如经度和纬度数据。Superset 支持 Mapbox 地图。要使用 Mapbox 可视化,您需要一个 Mapbox API 密钥。请注册 [Mapbox 免费使用层](https://account.mapbox.com/auth/signup/),并生成一个 API 密钥。

API 密钥提供给 Superset:
使 API 密钥可用于 Superset:

```bash
echo "MAPBOX_API_KEY=pk.SAMPLE-Use-your-key-instead" >> docker/.env-non-dev
```

## 部署 Superset 版本 2.0.0 {#deploy-superset-version-200}

要部署 2.0.0 版本,请运行
要部署 2.0.0 版本,运行

```bash
git checkout 2.0.0
Expand Down
Original file line number Diff line number Diff line change
@@ -1 +1 @@
ccc68e13430eae91
38d1ab0953d5112c
Loading