influxdb3 create table
influxdb3 create table 命令会在指定的数据库中创建一个新表。表必须至少包含一个标签列，并且可以选择性地包含具有已定义数据类型的字段列。
当您写入行协议数据时，InfluxDB 会自动创建表。仅当您需要在写入数据之前定义自定义模式或应用自定义分区模板时，才使用此命令。
用法
influxdb3 create table [OPTIONS] \
--tags [<TAGS>...] \
--database <DATABASE_NAME> \
--token <AUTH_TOKEN> \
<TABLE_NAME>参数
- TABLE_NAME: 要创建的表的名称。
选项
| 选项 | 描述 | |
|---|---|---|
-H | --host | 正在运行的 InfluxDB 3 Core 服务器的主机 URL (默认为 http://127.0.0.1:8181) |
-d | --database | (必需) 要操作的数据库名称 |
--token | (必需) 认证令牌 | |
--tags | (必需) 要包含在表中的标签列的逗号分隔列表 | |
--fields | 要包含在表中的字段列及其类型的逗号分隔列表 | |
--tls-ca | 自定义 TLS 证书颁发机构的路径（用于测试或自签名证书） | |
-h | --help | 打印帮助信息 |
--help-all | 打印详细帮助信息 |
标签和字段命名要求
标签和字段键是字母数字的，并且必须以字母或数字开头。它们可以包含连字符 (-) 和下划线 (_)。
可选环境变量
您可以使用以下环境变量来设置选项，而不是通过 CLI 标志传递它们
| 环境变量 | 选项 |
|---|---|
INFLUXDB3_HOST_URL | --host |
INFLUXDB3_DATABASE_NAME | --database |
INFLUXDB3_AUTH_TOKEN | --token |
示例
在以下示例中，请将每个占位符替换为您实际的值
DATABASE_NAME: 数据库名称AUTH_TOKEN: 身份验证令牌TABLE_NAME: 新表的名称
创建一个空表
influxdb3 create table \
--tags tag1,tag2,tag3 \
--database DATABASE_NAME \
--token AUTH_TOKEN \
TABLE_NAME创建一个带有标签列和字段列的表
influxdb3 create table \
--tags room,sensor_id \
--fields temp:float64,hum:float64,co:int64 \
--database DATABASE_NAME \
--token AUTH_TOKEN \
TABLE_NAME验证
使用 SHOW TABLES 查询来验证表是否已成功创建
influxdb3 query \
--database my_test_db \
--token AUTH_TOKEN \
"SHOW TABLES"
Example output:
+---------------+--------------------+----------------------------+------------+
| table_catalog | table_schema | table_name | table_type |
+---------------+--------------------+----------------------------+------------+
| public | iox | my_sensor_table | BASE TABLE |
| public | system | distinct_caches | BASE TABLE |
| public | system | last_caches | BASE TABLE |
| public | system | parquet_files | BASE TABLE |
+---------------+--------------------+----------------------------+------------+SHOW TABLES 是一个 SQL 查询。它在 InfluxQL 中不受支持。
此页面是否有帮助？
感谢您的反馈！
支持和反馈
感谢您成为我们社区的一员！我们欢迎并鼓励您对 InfluxDB 3 Core 和本文档提供反馈和错误报告。要获得支持，请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。