メインコンテンツまでスキップ
バージョン: 26.x

AUTO_PARTITION_NAME

説明​

AUTO_PARTITION_NAME関数は、自動パーティションのパーティション名を生成するために使用されます。この関数は2つのモードをサポートしています：RANGEモードは時間単位に基づいてパーティション名を生成し、LISTモードは文字列値に基づいてパーティション名を生成します。

Apache Doris 2.1.6以降でサポートされています。

構文​

AUTO_PARTITION_NAME('RANGE', <unit>, <datetime>)
AUTO_PARTITION_NAME('LIST', <value>[, <value> ...])

パラメータ​

パラメータ説明
'RANGE'RANGEパーティションモード、時間に基づいてパーティション名を生成
'LIST'LISTパーティションモード、文字列値に基づいてパーティション名を生成
<unit>RANGEモード用の時間単位: year, month, day, hour, minute, second。型: VARCHAR
<datetime>RANGEモード用の日時値。型: DATETIME
<value>LISTモード用のパーティション値（複数可）。型: VARCHAR

戻り値​

VARCHAR型を返し、生成されたパーティション名を表します。

特別なケース:

  • RANGEモード: パーティション名の形式はpYYYYMMDDHHMMSSで、単位に基づいて対応する精度に切り詰められます
  • LISTモード: パーティション名の形式はp<value><length>で、複数の値は長さで区切られます
  • パラメータが無効な場合、エラーを返します

例​

  1. 基本的な使用法: 日単位でのRANGE
SELECT auto_partition_name('range', 'day', '2022-12-12 19:20:30');
+------------------------------------------------------------+
| auto_partition_name('range', 'day', '2022-12-12 19:20:30') |
+------------------------------------------------------------+
| p20221212000000                                            |
+------------------------------------------------------------+
  1. 月別のRANGE
SELECT auto_partition_name('range', 'month', '2022-12-12 19:20:30');
+--------------------------------------------------------------+
| auto_partition_name('range', 'month', '2022-12-12 19:20:30') |
+--------------------------------------------------------------+
| p20221201000000                                              |
+--------------------------------------------------------------+
  1. LIST 単一値
SELECT auto_partition_name('list', 'helloworld');
+-------------------------------------------+
| auto_partition_name('list', 'helloworld') |
+-------------------------------------------+
| phelloworld10                             |
+-------------------------------------------+
  1. 複数の値をLISTする
SELECT auto_partition_name('list', 'hello', 'world');
+-----------------------------------------------+
| auto_partition_name('list', 'hello', 'world') |
+-----------------------------------------------+
| phello5world5                                 |
+-----------------------------------------------+
  1. UTF-8特殊文字サポート: LISTモード
SELECT auto_partition_name('list', 'ṭṛì', 'ḍḍumai');
+------------------------------------------------+
| auto_partition_name('list', 'ṭṛì', 'ḍḍumai')  |
+------------------------------------------------+
| pṭṛì9ḍḍumai12                                  |
+------------------------------------------------+
  1. 無効な単位パラメータ
SELECT auto_partition_name('range', 'years', '2022-12-12');
ERROR 1105 (HY000): errCode = 2, detailMessage = range auto_partition_name must accept year|month|day|hour|minute|second for 2nd argument

キーワード​

AUTO_PARTITION_NAME,AUTO,PARTITION,NAME