DataHub:用語

用語

説明

プロジェクト

• プロジェクトは DataHub のデータの基本的な組織単位であり、複数の Topic を含みます。

• DataHub プロジェクトは MaxCompute プロジェクトから独立しています。

Topic

Topic は DataHub でのデータサブスクリプションとパブリッシングの最小単位です。Topic を使用して、ストリーミングデータのクラスまたはタイプを表すことができます。

Topic の有効期間 (TTL)

Topic の有効期間 (TTL) は、Topic に書き込まれたデータの最大保持期間を指定します。単位は日です。値の範囲は 1 から 7 です。

シャード

シャードは、Topic 内のデータ転送用の同時実行チャネルです。各シャードには一意の ID があります。

有効化されたシャードはサーバーリソースを消費します。必要に応じてシャードを作成してください。

シャードのさまざまな状態の詳細については、「シャードの状態」をご参照ください。

Shard Hash Key Range

ハッシュキー値の範囲を指定するシャードのプロパティです。範囲は左側が閉じており、右側が開いています。

同じキーを持つデータは同じシャードに書き込まれます。

シャードマージ

シャードマージは、隣接したキー範囲を持つシャードを単一のシャードにマージする操作です。

詳細については、「シャード操作」をご参照ください。

Shard Split

Shard Split は、シャードを隣接したシャードキー範囲を持つ 2 つのシャードに分割する操作です。

Record

ユーザーデータと DataHub 間のデータインタラクションの基本単位です。

RecordType

Topic のデータの型。DataHub は Tuple 型と BLOB 型をサポートしています。

• Tuple 型の Topic は、データベースのようなデータレコードをサポートします。各レコードには複数の列が含まれます。

• BLOB 型の Topic は、バイナリデータのブロックのみの書き込みをサポートします。

サポートされているデータの型の詳細については、「データの型」をご参照ください。

状態

説明

読み書きのサポート

Opening

Topic が作成されると、すべてのシャードは初期化中に Opening 状態になります。

読み取りおよび書き込み操作はサポートされていません。

Active

シャードチャネルが開かれると、シャードは Active 状態になります。

通常の読み取りおよび書き込み操作がサポートされています。

Closing

シャードは、分割またはマージ操作が行われると Closing 状態になります。

読み取りおよび書き込み操作はサポートされていません。

Closed

分割またはマージ操作が完了すると、シャードは Closed 状態になります。

読み取り専用です。

ErrorCode

HttpCode

説明

InvalidUriSpec

400

リクエストされた URI は無効です。

InvalidParameter

400

無効なパラメーターです。詳細については、返されたエラーメッセージをご参照ください。

Unauthorized

401

署名エラーです。

NoPermission

403

アカウントの権限が不十分です。

InvalidSchema

400

スキーマのフォーマットが無効です。

InvalidCursor

400

カーソルが無効か、または期限切れです。

NoSuchProject

404

リクエストされたプロジェクトは存在しません。

NoSuchTopic

404

リクエストされた Topic は存在しません。

NoSuchShard

404

リクエストされたシャード ID は存在しません。

ProjectAlreadyExist

400

プロジェクトは既に存在します。

TopicAlreadyExist

400

Topic は既に存在します。

InvalidShardOperation

405

無効なシャード操作です。たとえば、シャードが閉じられた後にデータを書き込むなどです。

LimitExceeded

400

リクエストパラメーターが制限を超えています。たとえば、シャードの総数が 512 を超えています。

InternalServerError

500

不明なエラー、内部サービス例外、またはシステムアップグレードが進行中です。