본문으로 건너뛰기
최종 수정: 에

TIMESTAMPTZ

설명​

TIMESTAMPTZ는 시간대를 고려하여 날짜와 시간 정보를 저장하는 데 사용하는 Doris의 데이터 타입으로, 표준 SQL의 TIMESTAMP WITH TIME ZONE에 해당합니다.

데이터베이스 시스템마다 시간대를 인식하는 타임스탬프 타입의 이름이 다릅니다:

  • PostgreSQL과 Oracle은 TIMESTAMP WITH TIME ZONE을 사용합니다
  • SQL Server는 DATETIMEOFFSET을 사용합니다
  • 일부 다른 데이터베이스는 TIMESTAMP WITH LOCAL TIME ZONE을 사용합니다

SQL 표준에 따르면 독립적인 TIMESTAMP 타입은 시간대 정보를 포함하지 않아야 합니다(TIMESTAMP WITHOUT TIME ZONE과 동일). 사용자에게 익숙한 방식과 사용 편의성을 고려하여 Doris는 시간대가 있는 타임스탬프 타입을 나타내는 더 간결한 이름인 TIMESTAMPTZ를 선택했습니다. Doris에는 독립적인 TIMESTAMP 타입이 없습니다. 시간대 정보가 없고 넓은 범위를 지원하는 값에는 DATETIME을 사용하고, 시간대 정보가 없고 나노초 정밀도가 고정된 값에는 TIMESTAMP_NS를 사용하세요.

TIMESTAMPTZ의 범위는 DATETIME과 동일한 [0000-01-01 00:00:00.000000, 9999-12-31 23:59:59.999999]입니다. TIMESTAMPTZ는 TIMESTAMPTZ(p) 형식으로 정밀도를 지정할 수 있습니다. 여기서 p는 정밀도를 나타내며 [0, 6] 범위의 값을 가질 수 있고 기본값은 0입니다. 즉, TIMESTAMPTZ는 TIMESTAMPTZ(0)과 동일합니다. 기본 출력 형식은 'yyyy-MM-dd HH:mm:ss.SSSSSS +XX:XX'이며, +XX:XX는 시간대 오프셋을 나타냅니다(SSSSSS의 자릿수는 정밀도 p에 따라 결정됩니다).

TIMESTAMPTZ 타입은 기본 키, 파티션 컬럼, 버킷 컬럼으로 사용할 수 있습니다.

동작 원리​

TIMESTAMPTZ는 데이터의 각 행에 시간대 정보를 함께 저장하지 않고 다음과 같이 동작합니다:

  1. 저장 시: 입력된 모든 시간 값을 UTC(협정 세계시)로 변환합니다.
  2. 쿼리 시: 세션의 시간대 설정(time_zone 변수로 지정)에 따라 UTC 시간을 해당 시간대로 자동 변환하여 표시합니다.

따라서 TIMESTAMPTZ는 시간대 변환 기능이 있는 DATETIME 타입으로 이해할 수 있으며, Doris가 내부적으로 시간대 변환을 자동 처리합니다.

시간대 처리 규칙​

  • 입력 문자열에 시간대 정보가 포함된 경우(예: "2020-01-01 00:00:00 +03:00"), Doris는 해당 시간대 정보를 사용하여 변환합니다.
  • 입력 문자열에 시간대 정보가 포함되지 않은 경우(예: "2020-01-01 00:00:00"), Doris는 현재 세션의 시간대 설정을 사용하여 변환합니다.

4.1.5부터 출력 시 과거 IANA 시간대 오프셋을 +HH:MM:SS 형식으로 초 단위 정밀도까지 보존합니다. 입력 타임스탬프의 숫자 형식 오프셋은 고정 세션 오프셋과 제약 조건이 다릅니다. 입력의 시는 24 미만이어야 하고, 분과 초는 60 미만이어야 합니다. 고정 세션 오프셋은 계속 -12:00에서 +14:00 사이로 제한됩니다. 세션 시간대로 변환한 결과의 현지 연도가 0에서 9999 사이를 벗어나면 변환에 실패합니다.

4.1.5부터 Catalog는 외부의 시간대 인식 타임스탬프 타입을 항상 TIMESTAMPTZ에 매핑합니다. 호환성 속성 enable.mapping.timestamp_tz=false를 설정해도 이전의 DATETIME 매핑으로 되돌릴 수 없습니다. Arrow Flight SQL은 시간대 주석이 있는 Arrow Timestamp 값으로 시점을 전달합니다. 쿼리 스키마는 세션 시간대를 사용합니다(Z는 UTC로 정규화됩니다). DATETIME은 시간대 주석이 없는 Timestamp를 사용합니다.

저장 공간 및 사용​

Doris에서 TIMESTAMPTZ 타입 필드는 8바이트의 저장 공간을 차지합니다.

TIMESTAMPTZ는 DATETIME 및 TIMESTAMP_NS와의 양방향 변환을 지원하며, 변환 중 시간대를 적절히 조정합니다. TIMESTAMPTZ는 DATETIME으로의 암시적 변환을 지원하므로 TIMESTAMPTZ를 직접 지원하지 않는 함수도 이 타입의 데이터를 처리할 수 있습니다. TIMESTAMP_NS를 TIMESTAMPTZ로 변환하면 나노초 정밀도에서 대상 TIMESTAMPTZ 정밀도로 반올림합니다.

예제​

-- Using the current time zone (assuming +08:00) to convert a time string without time zone information
select cast("2020-01-01 00:00:00" as timestamptz);
+--------------------------------------------+
| cast("2020-01-01 00:00:00" as timestamptz) |
+--------------------------------------------+
| 2020-01-01 00:00:00 +08:00                 |
+--------------------------------------------+
-- TIMESTAMPTZ supports microseconds
select cast("2020-01-01 00:00:00.123456" as timestamptz(5));
+------------------------------------------------------+
| cast("2020-01-01 00:00:00.123456" as timestamptz(5)) |
+------------------------------------------------------+
| 2020-01-01 00:00:00.12345 +08:00                     |
+------------------------------------------------------+
-- Using a time string with time zone information
select cast("2020-01-01 00:00:00 +03:00" as timestamptz);
+---------------------------------------------------+
| cast("2020-01-01 00:00:00 +03:00" as timestamptz) |
+---------------------------------------------------+
| 2020-01-01 05:00:00 +08:00                        |
+---------------------------------------------------+
-- Converting TIMESTAMPTZ to DATETIME (with time zone conversion based on current time zone)
select cast(cast("2020-01-01 00:00:00 +03:00" as timestamptz) as datetime);
+---------------------------------------------------------------------+
| cast(cast("2020-01-01 00:00:00 +03:00" as timestamptz) as datetime) |
+---------------------------------------------------------------------+
| 2020-01-01 05:00:00                                                 |
+---------------------------------------------------------------------+
-- Converting DATETIME to TIMESTAMPTZ
select cast(cast('2023-01-02 01:00:00' as datetime) as timestamptz);
+--------------------------------------------------------------+
| cast(cast('2023-01-02 01:00:00' as datetime) as timestamptz) |
+--------------------------------------------------------------+
| 2023-01-02 01:00:00 +08:00                                   |
+--------------------------------------------------------------+
-- Using TIMESTAMPTZ in functions
select HOUR(cast("2020-01-01 00:00:00 +03:00" as timestamptz));
+---------------------------------------------------------+
| HOUR(cast("2020-01-01 00:00:00 +03:00" as timestamptz)) |
+---------------------------------------------------------+
|                                                       5 |
+---------------------------------------------------------+
Report issue