- StarRocks介绍
- 快速开始
- 表设计
- 数据导入
- 数据提取
- 使用StarRocks
- 参考手册
- SQL参考
-
用户账户管理
-
集群管理
- ADMIN CANCEL REPAIR
- ADMIN CHECK TABLET
- ADMIN REPAIR
- ADMIN SET CONFIG
- ADMIN SET REPLICA STATUS
- ADMIN SHOW CONFIG
- ADMIN SHOW REPLICA DISTRIBUTION
- ADMIN SHOW REPLICA STATUS
- ALTER SYSTEM
- CANCEL DECOMMISSION
- CREATE FILE
- DROP FILE
- ENTER
- INSTALL PLUGIN
- LINK DATABASE
- MIGRATE DATABASE
- SHOW BACKENDS
- SHOW BROKER
- SHOW FRONTENDS
- SHOW FULL COLUMNS
- SHOW INDEX
- SHOW MIGRATIONS
- SHOW PLUGINS
- SHOW TABLE STATUS
- SHOW FILE
- UNINSTALL PLUGIN
-
DDL
- ALTER DATABASE
- ALTER TABLE
- ALTER VIEW
- BACKUP
- CANCEL BACKUP
- CANCEL RESTORE
- CREATE DATABASE
- CREATE INDEX
- CREATE MATERIALIZED VIEW
- CREATE REPOSITORY
- CREATE RESOURCE
- CREATE TABLE LIKE
- CREATE TABLE
- CREATE VIEW
- CREATE FUNCTION
- DROP DATABASE
- DROP INDEX
- DROP MATERIALIZED VIEW
- DROP REPOSITORY
- DROP RESOURCE
- DROP TABLE
- DROP VIEW
- DROP FUNCTION
- HLL
- RECOVER
- RESTORE
- SHOW RESOURCES
- SHOW FUNCTION
- TRUNCATE TABLE
-
DML
- ALTER ROUTINE LOAD
- BROKER LOAD
- CANCEL LOAD
- DELETE
- EXPORT
- GROUP BY
- INSERT
- PAUSE ROUTINE LOAD
- RESUME ROUTINE LOAD
- ROUTINE LOAD
- SELECT
- SHOW ALTER
- SHOW BACKUP
- SHOW DATA
- SHOW DATABASES
- SHOW DELETE
- SHOW DYNAMIC PARTITION TABLES
- SHOW EXPORT
- SHOW LOAD
- SHOW PARTITIONS
- SHOW PROPERTY
- SHOW REPOSITORIES
- SHOW RESTORE
- SHOW ROUTINE LOAD
- SHOW ROUTINE LOAD TASK
- SHOW SNAPSHOT
- SHOW TABLES
- SHOW TABLET
- SHOW TRANSACTION
- SPARK LOAD
- STOP ROUTINE LOAD
- STREAM LOAD
-
数据类型
-
辅助命令
-
- 函数参考
- 日期函数
- convert_tz
- curdate
- current_timestamp
- curtime
- datediff
- date_add
- date_format
- date_sub
- date_trunc
- day
- dayname
- dayofmonth
- dayofweek
- dayofyear
- from_days
- from_unixtime
- hour
- minute
- month
- monthname
- now
- second
- str_to_date
- timediff
- timestampadd
- timestampdiff
- to_date
- to_days
- unix_timestamp
- utc_timestamp
- weekofyear
- year
- 地理位置函数
- 字符串函数
- JSON函数
- 聚合函数
- Bitmap函数
- 数组函数
- cast函数
- hash函数
- 日期函数
- 系统变量
- 错误码
- 系统限制
- SQL参考
- 管理手册
- 常见问题解答
- 性能测试
- Release Notes
时区
StarRocks 支持多时区设置
基本概念
StarRocks 内部存在多个时区相关参数
system_time_zone: 当服务器启动时,会根据机器设置时区自动设置,设置后不可修改。
time_zone: 服务器当前时区,区分session级别和global级别
具体操作
SHOW variables like '%time_zone%'
查看当前时区相关配置
SET time_zone = 'Asia/Shanghai'
该命令可以设置session级别的时区,连接断开后失效
SET global time_zone = 'Asia/Shanghai'
该命令可以设置global级别的时区参数,fe会将参数持久化,连接断开后不失效
时区的影响
时区设置会影响对时区敏感的时间值的显示和存储。
包括NOW()或CURTIME()等时间函数显示的值,也包括show load, show backends中的时间值。
但不会影响 create table 中时间类型分区列的 less than 值,也不会影响存储为 date/datetime 类型的值的显示。
受时区影响的函数:
- FROM_UNIXTIME:给定一个 UTC 时间戳,返回指定时区的日期时间:如
FROM_UNIXTIME(0)
, 返回 CST 时区:1970-01-01 08:00:00
。 - UNIX_TIMESTAMP:给定一个指定时区日期时间,返回 UTC 时间戳:如 CST 时区
UNIX_TIMESTAMP('1970-01-01 08:00:00')
,返回:0
。 - CURTIME:返回当前时区时间:如
CURTIME()
,返回:16:34:05
。 - NOW:返回当前时区日期时间:如
NOW()
,返回:2021-02-11 16:34:13
。 - CONVERT_TZ:将一个日期时间从一个指定时区转换到另一个指定时区。如
CONVERT_TZ('2021-08-01 11:11:11', 'Asia/Shanghai', 'America/Los_Angeles');
返回:2021-07-31 20:11:11
。
使用限制
时区值可以使用几种格式给出,不区分大小写:
表示UTC偏移量的字符串,如'+10:00'或'-6:00'
标准时区格式,如"Asia/Shanghai"、"America/Los_Angeles"
不支持缩写时区格式,如"MET"、"CTT"。因为缩写时区在不同场景下存在歧义。
为了兼容StarRocks,支持CST缩写时区,内部会将CST转移为"Asia/Shanghai"的中国标准时区
默认时区
系统default timezone为"Asia/Shanghai",当导入时,如果服务器时区为其他时区,需要指定相应时区,否则日期字段会不一致。
例如系统时区为UTC时,未指定情况下导入结果的日期字段会出现+8h的异常结果,需要在导入的参数部分指定时区,具体参数指定参考对应Load章节的参数说明。