# データテーブル

データテーブルはデータアクセス方法の1つですが、SDKデータ送信もあります。操作メンバーは分析のために独自のデータをデータテーブルにインポートできます。

現状、データテーブルはイベントプロパティとユーザープロパティの参照テーブルとして使用でき、テーブルファイルをインポートすることでデータテーブルを更新できます。

# データテーブル作成

テーブルファイルをインポートし、新しいデータテーブルを作成します（csv ファイルの保存方法をご参照ください）。Excel形式のファイルは100Mを超えることはできず、csv形式のファイルは 500Mを超えることはできません。データファイルが上記の範囲を超える場合は、増分更新によって作成され複数のバッチでインポートできます。

新しく作成されたデータテーブルの列名は、アップロードされたテーブルファイルの列名 (最初の行) と一致しており、ユーザーは各フィールドのデータ型も指定する必要があります。テーブルのメインキーのデータ型は、作成後に変更できないのでご注意ください。メインキーのデータ型は、関連付けることができるプロパティの範囲に影響します。詳細は、次の表をご参照ください。

プロパティデータ型	参照テーブルの追加説明
文字列、値、ブール値	参照テーブルを追加できます。テーブルのメインキーのデータ型は、プロパティのデータ型と同じである必要があります。
時間	参照テーブルを追加できます。テーブルのメインキーのデータ型は文字列である必要があり、時間形式を指定する必要があります。
リスト	参照テーブルを追加できます。テーブルのメインキーのデータ型は文字列である必要があります。
オブジェクトオブジェクトグループ	参照テーブルのプロパティは追加できません。オブジェクトのサブプロパティは、参照テーブルを追加できます。

プレビューで各列のデータ分析が正常か否かを確認後、エラーの詳細をダウンロードしてテーブルで解析に失敗したデータ行を取得できます。

テーブルファイル内のデータは自動的に新しいテーブルに挿入されます。ファイル内の異なる行のデータの最初の列が同じ値の場合、重複排除後にデータテーブルに挿入されます。重複排除方法は同じ値の中で行番号が最小データとなります。 (Tips：Schemaによってアップロードされたテーブルの最初の列はデフォルトでメインキーであるため、メインキーの値を繰り返すことはできず、自動的に重複排除されます）

# データ更新

増分更新は比較的軽量な更新方法です。更新時に少量の変更されたデータをインポートするだけで済みます。インポートされたデータのメインキーフィールドの値がデータテーブルに既に存在する場合、更新が実行されます。メ存在しない場合は新しいデータが挿入されます。この更新方法は、インポートされたテーブルファイルに表示されないメインキー値のデータには影響しません。

1回のアップロードファイルのサイズには制限があるため（Excel 形式のファイルは100Mを超えることはできず、csv形式のファイルは 500M を超えることはできません）さらに多くのデータを更新する必要がある場合は、複数回のインポートで実現できます。

増量更新のテーブルの構造は、現在のデータテーブルと完全に一致している必要があります (列名と列の順序が含まれます)。

変更されるデータの範囲が大きい場合や一部のデータを削除する必要がある場合は、置換え更新を使用することをお勧めします。この更新メソッドは、最初に元のデータテーブルのデータをクリアしてからテーブルにインポートされたすべてのデータをテーブルに書き込みます。テーブルファイルの要件は、増分更新の要件と同じです。

データテーブルAPI を使用してデータテーブルを更新することもできます。ユーザーが v3.8 より前に作成された参照テーブルを使用している場合、データは参照テーブルAPIを介して更新できます。

# データテーブル管理

データテーブルでは、テーブル構造の更新、テーブルの削除、およびテーブルとデータのバージョンの復元などの管理操作を作成されたデータに対して実行できます。

テーブルフィールドの表示名を調整する必要がある場合は、増量更新に変更できます。列を追加または削除する必要がある場合、または列のデータ型を変更する必要がある場合 (メインキーフィールドはデータ型の変更を対応していません)、置換え更新に変更できます。

テーブル構造の変更は、このデータテーブルを使用するアセットに影響するため、有効にするには公開する必要があります。リストのステータス列では、データテーブルに未公開の更新があることも通知されます。公開する際には、テーブル構造と関連する影響を確認する必要があります。

データテーブルのデータまたは構造が変更された後、それを返す必要がある場合は、データテーブルのバージョンレコードを復元できます。復元される内容には、データテーブル構造とデータテーブル内のデータが含まれますが、データテーブルとプロパティの間の関係は含まれないことにご注意ください。

データテーブルを削除すると復元することができません。データテーブルを参照テーブルとして追加した場合、データテーブルを削除すると作成した参照テーブルのプロパティが同期的に削除されます。

データテーブルAPI を介してデータテーブルを管理することもできます。

# データテーブル使用

データテーブルでは、1つまたは複数のプロパティを持つ参照テーブルとして直接追加できます（詳細はデータテーブル関連プロパティを参照してください）もちろん、ユーザープロパティとイベントプロパティにデータテーブルを参照テーブルとして追加することもできます。

# 使用権限

項目	内容	ルートアカウント	管理者	アナリスト	メンバー
元データ閲覧	データテーブルのプレビュー、プロパティ参照テーブルのエクスポート、データテーブルの内容のダウンロード、データテーブルの履歴内容のダウンロード	◎	◎	○	×
元データ編集	データテーブルの新規追加、データテーブルの編集、データテーブルの履歴バージョンの復元	◎	◎	○	×

権限説明：

◎ 付与されている

○ デフォルトで付与されているが、除外可能

△ デフォルトで付与されていないが、付与可能

× 付与されていない