[Doc] add table name insensitive doc (backport #61923) (#61974)

Signed-off-by: stephen <stephen5217@163.com>
Signed-off-by: 絵空事スピリット <wanglichen@starrocks.com>
Co-authored-by: stephen <91597003+stephen-shelby@users.noreply.github.com>
Co-authored-by: 絵空事スピリット <wanglichen@starrocks.com>
This commit is contained in:
mergify[bot] 2025-08-15 15:02:20 +08:00 committed by GitHub
parent 9df260eee1
commit 492586e993
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
6 changed files with 55 additions and 4 deletions

View File

@ -1169,6 +1169,18 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
- Description: The interval at which the Automated Cluster Snapshot tasks are triggered.
- Introduced in: v3.4.2
##### enable_table_name_case_insensitive
- Default: false
- Type: Boolean
- Unit: -
- Is mutable: No
- Description: Whether to enable case-insensitive processing on catalog names, database names, table names, view names, and materialized view names. Currently, table names are case-sensitive by default.
- After enabling this feature, all related names will be stored in lowercase, and all SQL commands containing these names will automatically convert them to lowercase.
- You can enable this feature only when creating a cluster. **After the cluster is started, the value of this configuration cannot be modified by any means**. Any attempt to modify it will result in an error. FE will fail to start when it detects that the value of this configuration item is inconsistent with that when the cluster was first started.
- Currently, this feature does not support JDBC catalog and table names. Do not enable this feature if you want to perform case-insensitive processing on JDBC or ODBC data sources.
- Introduced in: v4.0
### User, role, and privilege
##### privilege_max_total_roles_per_user

View File

@ -8,7 +8,7 @@ This topic describes the rules and limits that apply when you use StarRocks.
- StarRocks uses the MySQL protocol for communication. You can connect to the StarRocks cluster via a MySQL client or JDBC. We recommend that you use a MySQL client whose version is 5.1 or later. Versions earlier than 5.1 do not support usernames that are longer than 16 characters.
- Naming conventions for objects such as catalogs, databases, tables, views, partitions, columns, indexes, usernames, roles, repositories, resources, storage volumes, and pipes:
- Naming conventions for objects such as catalogs, databases, tables, views, asynchronous materialized views, partitions, columns, indexes, usernames, roles, repositories, resources, storage volumes, and pipes:
- The name can only consist of digits (0-9), letters (a-z or A-Z), and underscores (\_). **Usernames can be all digits.**
- The name can start with a letter or an underscore (\_).
@ -18,6 +18,11 @@ This topic describes the rules and limits that apply when you use StarRocks.
- Username cannot exceed 128 characters.
- Column name (column alias), partition name, and index name are **not** case-sensitive. Other names are **case-sensitive**.
- The FE configuration item `enable_table_name_case_insensitive` (supported from v4.0 onwards) allows you to control whether data directory names, database names, table names, view names, and asynchronous materialized view names are case-insensitive. Currently, table names are case-sensitive by default.
- After enabling this feature, all related names will be stored in lowercase, and all SQL commands containing these names will automatically convert them to lowercase.
- You can enable this feature only when creating a cluster. **After the cluster is started, the value of this configuration cannot be modified by any means**. Any attempt to modify it will result in an error. FE will fail to start when it detects that the value of this configuration item is inconsistent with that when the cluster was first started.
- Currently, this feature does not support JDBC catalog and table names. Do not enable this feature if you want to perform case-insensitive processing on JDBC or ODBC data sources.
- Naming conventions for labels:
You can specify the label of a job when you load data. The label name can consist of digits (0-9), letters (a-z or A-Z), and underscores (\_), and cannot exceed 128 characters in length. Label names can start with a letter or an underscore (\_).

View File

@ -800,6 +800,18 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
- 説明: 自動クラスタスナップショットのタスクがトリガされる間隔。
- 導入バージョン: v3.4.2
##### enable_table_name_case_insensitive
- デフォルト: false
- タイプ: Boolean
- 単位: -
- 変更可能: いいえ
- 説明: カタログ名、データベース名、テーブル名、ビュー名、および非同期マテリアライズドビュー名に対して、大文字小文字を区別しない処理を有効にするかどうか。現在、テーブル名はデフォルトで大文字小文字を区別します。
- この機能を有効にすると、関連するすべての名前が小文字で保存され、これらの名前を含むすべての SQL コマンドは自動的に小文字に変換されます。
- この機能はクラスターを作成する際にのみ有効にできます。**クラスターが起動された後、この設定項目の値はどのような手段でも変更できません**。この設定を変更しようとするとエラーが発生します。FE は、この設定項目の値がクラスターが最初に起動された際の値と一致しない場合、起動に失敗します。
- 現在は、この機能は JDBC カタログ名とテーブル名をサポートしていません。JDBC または ODBC データソースで大文字小文字を区別しない処理を実行したい場合は、この機能を有効にしないでください。
- 導入バージョン: v4.0
### ユーザー、ロール、および権限
##### privilege_max_total_roles_per_user

View File

@ -8,7 +8,7 @@ displayed_sidebar: docs
- StarRocks は通信に MySQL プロトコルを使用します。MySQL クライアントまたは JDBC を介して StarRocks クラスターに接続できます。バージョン 5.1 以降の MySQL クライアントを使用することを推奨します。5.1 より前のバージョンは、16 文字を超えるユーザー名をサポートしていません。
- カタログ、データベース、テーブル、ビュー、パーティション、カラム、インデックス、ユーザー名、ロール、リポジトリ、リソース、ストレージボリューム、パイプなどのオブジェクトの命名規則:
- カタログ、データベース、テーブル、ビュー、非同期マテリアライズドビュー、パーティション、カラム、インデックス、ユーザー名、ロール、リポジトリ、リソース、ストレージボリューム、パイプなどのオブジェクトの命名規則:
- 名前は数字 (0-9)、文字 (a-z または A-Z)、アンダースコア (\_) のみで構成できます。**ユーザー名はすべて数字でも構いません。**
- 名前は文字またはアンダースコア (\_) で始めることができます。
@ -18,6 +18,11 @@ displayed_sidebar: docs
- ユーザー名は 128 文字を超えることはできません。
- カラム名(カラムエイリアス)、パーティション名、インデックス名は**大文字と小文字を区別しません**。その他の名前は**大文字と小文字を区別します**。
- FE 設定項目 `enable_table_name_case_insensitive`v4.0 以降でサポート)を使用すると、データディレクトリ名、データベース名、テーブル名、ビュー名、および非同期マテリアライズドビュー名が大文字小文字を区別しないかどうかを制御できます。現在、テーブル名はデフォルトで大文字小文字を区別します。
- この機能を有効にすると、関連するすべての名前が小文字で保存され、これらの名前を含むすべての SQL コマンドは自動的に小文字に変換されます。
- この機能はクラスターを作成する際にのみ有効にできます。**クラスターが起動された後、この設定項目の値はどのような手段でも変更できません**。この設定を変更しようとするとエラーが発生します。FE は、この設定項目の値がクラスターが最初に起動された際の値と一致しない場合、起動に失敗します。
- 現在は、この機能は JDBC カタログ名とテーブル名をサポートしていません。JDBC または ODBC データソースで大文字小文字を区別しない処理を実行したい場合は、この機能を有効にしないでください。
- ラベルの命名規則:
データをロードする際にジョブのラベルを指定できます。ラベル名は数字 (0-9)、文字 (a-z または A-Z)、アンダースコア (\_) で構成でき、128 文字を超えることはできません。ラベル名は文字またはアンダースコア (\_) で始めることができます。
@ -33,4 +38,4 @@ displayed_sidebar: docs
- StarRocks は既存のテーブルのテーブルタイプを変更することをサポートしていません。例えば、重複キーテーブルを主キーテーブルに変更することはできません。新しいテーブルを作成する必要があります。
- デフォルトでは、クエリは最大 10,000 のサブクエリでネストすることができ、これは FE パラメータ `expr_children_limit` によって制御されます。
- デフォルトでは、クエリは最大 10,000 のサブクエリでネストすることができ、これは FE パラメータ `expr_children_limit` によって制御されます。

View File

@ -1161,6 +1161,18 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
- 描述:自动化集群快照任务的触发间隔。
- 引入版本v3.4.2
##### enable_table_name_case_insensitive
- 默认值false
- 类型Boolean
- 单位:-
- 是否动态:否
- 描述:是否启用针对 Catalog 名称、数据库名称、表名称、视图名称以及异步物化视图名称的大小写不敏感处理。目前,表名称默认区分大小写。
- 启用此功能后,所有相关名称将以小写形式存储,且所有包含这些名称的 SQL 命令将自动将其转换为小写。
- 您只能在创建集群时启用此功能。**集群启动后,此配置项的值无法通过任何方式修改**。任何修改尝试均会导致错误。当 FE 检测到此配置项的值与集群首次启动时不一致时FE 将无法启动。
- 目前,此功能不支持 JDBC Catalog 和表名。若需对 JDBC 或 ODBC 数据源进行大小写不敏感处理,请勿启用此功能。
- 引入版本v4.0
### 用户,角色及权限
##### privilege_max_total_roles_per_user

View File

@ -8,7 +8,7 @@ displayed_sidebar: docs
- StarRocks 采用 MySQL 协议进行通信,用户可通过 MySQL Client 或者 JDBC 连接到 StarRocks 集群。选择 MySQL Client 版本时建议采用 5.1 及之后的版本5.1 之前版本不支持长度超过 16 个字符的用户名。
- 对名称的要求,包括数据目录名 (catalog)、数据库名、表名、视图名、分区名、列名、索引名、用户名、角色名、仓库名 (repository)、资源名 (resource)、存储卷名 (Storage Volume)、Pipe 名等:
- 对名称的要求,包括数据目录名 (catalog)、数据库名、表名、视图名、异步物化视图名、分区名、列名、索引名、用户名、角色名、仓库名 (repository)、资源名 (resource)、存储卷名 (Storage Volume)、Pipe 名等:
- 只能由数字 (0-9)、字母 (a-z或A-Z),以及下划线 (\_) 组成。**用户名 (username) 可以使用纯数字命名。**
- 可以以字母或下划线开头。
- 长度不能超过 64 个字符。**几个特殊情况:**
@ -17,6 +17,11 @@ displayed_sidebar: docs
- 用户名 (username) 不能超过 128 个字符。
- 列名(包括列别名)、分区名、索引名大小写**不敏感**,其他名称大小写**敏感**。
- FE 配置项 `enable_table_name_case_insensitive`(自 v4.0 版本起支持)允许您控制 Catalog 名称、数据库名称、表名称、视图名称以及异步物化视图名称是否不区分大小写。目前,表名称默认区分大小写。
- 启用此功能后,所有相关名称将以小写形式存储,且所有包含这些名称的 SQL 命令将自动将其转换为小写。
- 您只能在创建集群时启用此功能。**集群启动后,此配置项的值无法通过任何方式修改**。任何修改尝试均会导致错误。当 FE 检测到此配置项的值与集群首次启动时不一致时FE 将无法启动。
- 目前,此功能不支持 JDBC Catalog 和表名。若需对 JDBC 或 ODBC 数据源进行大小写不敏感处理,请勿启用此功能。
- 对标签Label名的要求
导入数据时可指定任务的标签Label。标签名可由数字 (0-9)、字母a-z或A-Z以及下划线(\_)组成,且长度不能超过 128 个字符。标签名以字母或下划线开头。