📣新登場！TiDB Cloud BYOC、TiDB Cloud Filesystem、PostgreSQL-compatible TiDB Cloud Starter がパブリックプレビュー中。このページは自動翻訳されたものです。原文はこちらからご覧ください。
AI
開発者
ベストプラクティス
API

TiDB データソース (Preview)

TiDB データソースには、TiDB クラスターによって stage 済みのデータを TiDB Cloud Lake が読み取るために使用する、オブジェクトストレージの場所、認証情報、およびオプションのイベントキューが保存されます。これは TiDB サーバー自体には接続しません。Dumpling と TiCDC はエクスポートおよび変更イベントをオブジェクトストレージのバケットに書き込み、TiDB Cloud Lake はそのバケットから読み取ります。

ユースケース

  • 複数の TiDB 同期タスク向けに、stage 用バケット、認証情報、およびオプションの SQS キューを一元管理する
  • すべてのタスクで同じバケットと認可設定を毎回入力し直す手間を避ける
  • 静的キーの代わりに IAM Role を使用して、TiDB Cloud Lake が有効期限の短い認証情報を取得できるようにする
  • 複数のタスクから参照されているバケット、ロール、またはキューを 1 か所で更新する

統合のために TiDB を準備する

TiDB Cloud は、完全スナップショット (Dumpling) と増分変更 (TiCDC) をオブジェクトストレージのバケットにエクスポートします。TiDB Cloud の各プランには違いがあるため、設定を最小限に抑えつつデータ互換性を確保できるよう、プランごとに特定のセットアップ手順を推奨します。

TiDB データソースを作成する

  1. Data > Data Sources に移動し、Create をクリックします。

  2. サービスとして TiDB を選択し、データソースの Name を入力します。

  3. Storage Provider と Authentication Method を選択し、接続の詳細を入力します。表示されるフィールドは、選択した組み合わせによって異なります。詳細は以下の Amazon S3 または Alibaba Cloud OSS を参照してください。

  4. Test Connectivity をクリックして、バケットと認証情報を検証します。テストが成功したら、OK をクリックしてデータソースを保存します。

Amazon S3

ストレージプロバイダーが Amazon S3 の場合は、以下のいずれかの認証方式を選択します。

Role ARN は AssumeRole モデルを使用します。TiDB Cloud Lake は AWS アカウント内の IAM Role を引き受けて一時的な認証情報を取得するため、静的キーを TiDB Cloud Lake に渡す必要がありません。

データソースを保存する前に、IAM Role の信頼ポリシーで 2 つのプラットフォームロール (TiDB Cloud Lake のセットアップおよび検証ロール、ならびに TiDB Cloud Lake のデータロード用ロール) を信頼し、sts:ExternalId 条件に対応する外部 ID を指定する必要があります。完全な信頼ポリシー設定については、AWS IAM Role による認証 を参照してください。

フィールド必須説明
Nameはいこのデータソースを識別するための説明的な名前
Storage ProviderはいAmazon S3 を選択
Authentication MethodはいRole ARN を選択
Role ARNはいTiDB Cloud Lake が引き受けを許可されている AWS アカウント内の IAM Role ARN。例: arn:aws:iam::123456789012:role/tidbcloud-lake-tidb
S3 Bucket NameはいTiCDC / Dumpling が TiDB Cloud Lake によってロードされるデータを stage するバケット
S3 Regionはいバケットの AWS リージョン。例: us-east-1
S3 EndpointいいえMinIO などの S3 互換ストレージでのみ使用します。例: http://localhost:9000。Amazon S3 の場合は空のままにします
SQS Queue URLいいえイベント駆動モード用のオプションの SQS 標準キュー URL。オプションの SQS キュー を参照してください

認証方式: Access Key / Secret Key

この方式は、たとえばロール引き受けをサポートしない S3 互換ストアなど、静的認証情報を使用したい場合に利用します。

詳細は、Amazon S3 - Credentials を参照してください。

フィールド必須説明
Nameはいこのデータソースを識別するための説明的な名前
Storage ProviderはいAmazon S3 を選択
Authentication MethodはいAccess Key / Secret Key を選択
S3 Access Keyはいstage 用バケットにアクセスできるアクセスキー ID
S3 Secret Keyはいアクセスキー ID に対応するシークレットアクセスキー
S3 Bucket NameはいTiCDC / Dumpling が TiDB Cloud Lake によってロードされるデータを stage するバケット
S3 Regionはいバケットの AWS リージョン
S3 EndpointいいえS3 互換ストレージでのみ使用します。Amazon S3 の場合は空のままにします
SQS Queue URLいいえイベント駆動モード用のオプションの SQS 標準キュー URL

Alibaba Cloud OSS

ストレージプロバイダーが Alibaba Cloud OSS の場合、TiDB Cloud Lake は Alibaba Cloud から stage 用バケットを読み取ります。OSS では Access Key / Secret Key 認証のみサポートされます。

フィールド必須説明
Nameはいこのデータソースを識別するための説明的な名前
Storage ProviderはいAlibaba Cloud OSS を選択
OSS Access Key IDはいOSS AccessKey ID
OSS AccessKey SecretはいOSS AccessKey secret
OSS BucketはいTiCDC / Dumpling がデータを stage する OSS バケット
OSS Region読み取り専用Lake のデプロイリージョンです。自動的に表示され、変更できません

オプションの SQS キュー

SQS Queue URL フィールドはオプションであり、Amazon S3 にのみ適用されます。stage 用バケットに対する S3 ObjectCreated イベントを受信する標準 SQS キューを指定すると、TiDB Cloud Lake は次回のポーリングを待つ代わりに、そのキューから新しく書き込まれた changefeed / export オブジェクトを検出できます。

  • キューは標準キューである必要があります。FIFO キューはサポートされません。S3 のイベント通知をそれらに配信できないためです。
  • S3 バケットと SQS キューは同じリージョンに配置することを推奨します。
  • バケットのポーリングは引き続き正式な検出経路であり、SQS は置き換えではなくレイテンシー最適化です。
  • このフィールドを空のままにすると、タスクはポーリングによってオブジェクトを検出します。

キュー、バケット通知、および信頼ポリシーの設定については、Amazon SQS (S3) - IAM Role を参照してください。

次のステップ

このデータソースを作成した後、それを使用して TiDB 統合タスク を作成できます。

このページは役に立ちましたか？