Docs Menu
Docs Home
/ /
データ ストアを定義する
Docs Home
/
開発
/
Data Federation
/
データ ストアを定義する
Docs Home
/
開発
/
Data Federation
/
データ ストアを定義する

パーティション属性タイプの使用

注意

pathを指定する場合

  • パーティション属性のデータ型を指定します。

  • パーティション属性の型が解析するデータ型と一致していることを確認します。

  • delimiterで指定された区切り文字を使用します。

同じ型の属性を指定する場合は、以下のいずれかを行います。

  • 属性の間に定数のセパレーターを追加します。

  • 正規表現を使用して、検索パターンを記述します。詳細については、「サポートされていない解析関数」を参照してください。

サポートされているパーティション属性のタイプ

次の表は、パーティション属性、ファイル名、各データ型の ~databases.[n].collections.[n].dataSources.[n].path の例でサポートされているデータ型を示しています。

キー
データ型
例

string

ファイル名を string として解析します。

ファイル名: /employees/949-555-0195.json

path: /employees/{phone string}

上記の例では、Data Federation はphoneを string として解釈します。

詳細については、「ファイル名から null 値の解析 」を参照してください。

int

ファイル名を整数として解析します。

ファイル名: /zipcodes/90210.json

path: /zipcodes/{zipcode int}

前の例では、Data Federation はzipcodeを整数として解釈します。

詳細については、「ファイル名からパディングされた数字の解析 」を参照してください。

isodate

RFC 3339 形式のファイル名を ISO-8601形式の日付として解析します。

ファイル名: /metrics/20060102.json

  • path: /metrics/{startTimestamp isodate}

  • path: /metrics/{startTimestamp isodate('20060102')}

前述の例では、最初のパスで、Data Federation はstartTimestampをISODateとして解釈します。 2 番目のパスでは、Data Federation はstartTimestampを指定された形式のISODateとして解釈し、指定された形式のファイル名のみと一致させます。

上記の最初のISODate属性パスの例に示すように、特定の形式を指定しない場合、Atlas Data Federation はデフォルトで次の日付形式のパーティションを作成します。

1"2006-01-02T15:04:05Z07:00"
2"2006-01-02T15:04:05.000000Z07:00"
3"2006-01-02"
4"2006-01-02T15:04:05.000000-0700"
5"2006-01-02T15:04:05-0700"
6"2006-01-02T15:04Z07:00"
7"2006-01-02T15:04-0700"
8"2006-01-02Z07:00"
9"2006-01-02-0700"
10"2006102T15:04:05.000000Z07:00"
11"20060102T15:04:05.000000-0700"
12"20060102T15:04:05Z07:00"
13"20060102T15:04:05-0700"
14"20060102T15:04Z07:00"
15"20060102T15:04-0700"
16"20060102Z07:00"
17"20060102-0700"
18"20060102"

形式を指定してパフォーマンスを向上させる場合は、日（02）、月（01）、年（2006）など、日付内の属性の正確な位置を示すために特別な値を使用する必要がありますなど。日付の指定に使用される形式と値の詳細については、「 時刻または日付の形式 」を参照してください。RFC 3339形式に含まれない形式を指定する場合は、日付属性の位置を示すために、特殊な値とともに正規表現を使用する必要があります。 の例については、「 ISODateからのパーティションの作成 」を参照してください。

epoch_secs

ファイル名を Unix タイムスタンプとして秒単位で解析します。

ファイル名: /metrics/1549046112.json

path: /metrics/{startTimestamp epoch_secs}

前の例では、Data Federation はstartTimestampを秒単位の Unix タイムスタンプとして解釈します。

詳細については、「ファイル名からパディングされた数字の解析 」を参照してください。

epoch_millis

ファイル名を Unix タイムスタンプとしてミリ秒単位で解析します。

ファイル名: /metrics/1549046112000.json

path: /metrics/{startTimestamp epoch_millis}

前の例では、Data Federation はstartTimestampをミリ秒単位の Unix タイムスタンプとして解釈します。

詳細については、「ファイル名からパディングされた数字の解析 」を参照してください。

objectid

ファイル名をObjectId として解析します。

ファイル名: /metrics/507f1f77bcf86cd799439011.json

path: /metrics/{objid objectid}

前の例では、Data Federation はobjidをObjectId として解釈します。

uuid

ファイル名をバイナリ サブタイプ 4 の UUID として解析します。

ファイル名: /metrics/3b241101-e2bb-4255-8caf-4136c566a962.json

path: /metrics/{myUuid uuid}

前の例では、Data FederationmyUuid は をバイナリ サブタイプ の UUID4 として解釈します。

注意

Atlas Data Federation は、ファイル名へのパスで正規表現のパッケージシンタックスをサポートしています。

サポートされている変換

Atlas Data Federation は、 をファイル名に解析するときに、パーティション属性をBSONタイプに変換します。pathクラウドストレージへのデータの後での書き込みでは、string に変換した後、BSON types を使用する必要があります。次の表には、次の内容が示されています。

  • Data Federation がそれらを変換するパーティション属性タイプとBSONタイプ。

  • 後でクラウドストレージに書き込むように string に変換するBSONデータ型。

パーティション属性タイプ
解析済み BSON Type
ソースBSON Type

string

  • UTF-8 string

  • null*

  • UTF-8 string

  • null

int

  • 64 ビット整数

  • null

  • 32 ビット整数

  • 64 ビット整数

  • null（パディングのないstring）

isodate

  • UTC 日時

  • null

  • UTC 日時（ISO-8601形式文字列として）

  • null

objectid

  • ObjectId （16 進数でエンコードされた string として）

  • null

uuid

戻る

UI から作成

次へ

管理

項目一覧