オブジェクトストレージの設定

OceanBase Cloudでは、プロジェクト内でオブジェクトストレージの設定を一元的に作成および管理することができます。ログをご自身のオブジェクトストレージにプッシュする機能を利用する場合は、既に作成済みの設定を直接参照することができます。本記事では、プロジェクトのオブジェクトストレージ設定を管理する方法について説明します。

背景

OceanBase Cloudの複数の機能では、ログをお客様のオブジェクトストレージにプッシュする必要があります。各機能で個別にBucketとアクセス資格情報を入力すると、重複する保守コストが発生します。同一プロジェクト内で同じ資格情報を複数回入力する必要があり、資格情報をローテーションする際も各機能ごとに修正する必要があります。

そのため、OceanBase Cloudはプロジェクト内で統一されたオブジェクトストレージ設定の管理を提供します。プロジェクト内で一度設定を作成すれば、オブジェクトストレージを使用する機能からその設定を参照するだけで済み、Bucketとアクセス資格情報を繰り返し入力する必要はありません。後から資格情報をローテーションする際も、設定自体を変更するだけで、その設定を参照する機能は自動的に新しい資格情報を使用します。

使用制限

• オブジェクトストレージ設定はプロジェクトレベルのリソースであり、所属するプロジェクト内でのみ表示および参照可能です。同一組織内の複数のプロジェクトでは、別々に設定を作成する必要があります。

• オブジェクトストレージ設定の作成、変更、削除は、プロジェクト管理者またはプロジェクト設定権限を持つユーザーのみが行えます。

• 現在対応しているオブジェクトストレージは、Alibaba Cloud OSS、AWS S3、Azure Blob Storageです。

• 設定作成後、ストレージサービス、リージョン、**バケット名**は変更できません。変更が必要な場合は、新しい設定を作成してください。

• 設定がいずれかの機能に参照されている場合は、削除できません。

• 各機能が参照可能な設定には、追加の制約があります。例えば、SQL監査は、クラウドベンダーとリージョンがクラスタのものと一致し、状態が有効な設定のみを参照できます。

オブジェクトストレージ設定の追加

1. OceanBase Cloudコンソールにログインします。

2. 左上の組織ドロップダウンボックスで、対象の組織名をクリックします。

3. プロジェクトリストで対象のプロジェクトを見つけ、右側の**操作列のプロジェクトの設定**をクリックします。

4. **プロジェクト設定ページで、データ送信先**タブをクリックします。

5. **オブジェクトストレージタブで、オブジェクトストレージの追加**をクリックします。

6. ポップアップウィンドウで以下のパラメータを設定します。

   パラメータ	説明
   名称	設定の名前を入力します。これは各機能でこの設定を識別するために使用されます。長さは2文字以上64文字以下で、数字、英字、アンダースコア、ハイフンのみ使用できます。プロジェクト内で重複してはならず、作成後は変更可能です。
   ストレージサービス	オブジェクトストレージが属するクラウドベンダーを選択します。選択肢は**Alibaba Cloud OSS**、AWS S3、Azure Blob Storageです。作成後は変更できません。
   リージョン	オブジェクトストレージが存在するリージョンを入力します。例：cn-hangzhou。作成後は変更できません。
   エンドポイントアドレス(Endpoint)	システムは選択したストレージサービスプロバイダと入力したリージョンに基づいて、Endpointを自動生成します。手動で入力する必要はありません。
   バケット名	データを格納するためのBucket名を入力します。Azure Blob Storageの場合は、Container名を入力してください。作成後は変更できません。 OceanBase Cloudのネットワークセグメント(100.64.0.0/10)をこのBucketの許可リストに追加してください。追加しない場合、ログ配信は権限不足により失敗します。
   Access Key ID	有効なAccess Key IDを入力します。フィールドの右側にある**取得方法は？**リンクをクリックすると、取得方法を確認できます。AccessKey管理を参照してください。
   Access Key Secret	Access Key IDに対応するSecretを入力します。

7. **接続テスト**をクリックし、設定が使用可能かどうかを確認します。

   接続テストでは、必須項目がすべて入力されているか、設定名が一意であるか、Bucketが存在するか、Bucketのリージョンが選択したリージョンと一致するか、アクセス資格情報が有効であるかを検証します。また、Bucketにプローブオブジェクトを書き込み、書き込み権限が付与されているか確認します。

   検証に失敗する主な原因には、無効な資格情報、Bucketが存在しないこと、リージョンの不一致、書き込み権限の不足、ネットワークに接続できないことなどがあります。

   接続テスト中は、すべての構成パラメータが編集できなくなります。接続に成功すると、ボタンは成功状態に変わり、5秒のカウントダウンが始まります。カウントダウン終了後、ボタンの表示は「接続テスト」に戻ります。接続に失敗すると、フォームの下部にエラーメッセージが即座に表示されます。

8. 保存 をクリックし、設定の作成を完了します。

   説明

   保存時、OceanBase Cloudは再度接続検証を実行します。検証に失敗した場合は保存できません。

オブジェクトストレージ設定の表示

**データ送信先タブの下にあるオブジェクトストレージ**タブでは、現在のプロジェクトで作成された設定を表示および管理できます。リストには、設定名、ストレージサービスプロバイダ、リージョン、詳細、参照数、接続状態、更新時間が表示されます。

検索バーを使用して、設定名、リージョン、またはBucket名で設定を検索できます。また、ストレージサービスプロバイダや状態でフィルタリングすることもできます。

オブジェクトストレージ設定の変更

対象の設定の操作列にある 編集 をクリックすると、設定の 名称 とアクセス資格情報を変更できます。

• 設定名のみを変更しても、現在進行中のログプッシュには影響しません。この設定を参照する機能には新しい設定名が表示されます。

• アクセス資格情報を変更する場合は、新しい Access Key ID と Access Key Secret を同時に入力し、接続検証に再度合格する必要があります。保存後、この設定を参照する機能は新しい資格情報を使用します。

• ストレージサービス、リージョン、および バケット名 の変更はサポートされていません。

オブジェクトストレージ設定の削除

対象の設定の操作列にある 削除 をクリックして、オブジェクトストレージ設定を削除します。

• 設定が参照されている場合は削除できません。その際、ページには現在の参照数とこの設定を参照する機能が表示されます。まず、該当する機能での参照を解除する必要があります。例えば、SQL監査のストレージターゲットを他のストレージや他の設定に切り替えたうえで、その後に設定を削除します。

• 設定の削除は、オブジェクトストレージに書き込まれた履歴ファイルを削除するものではありません。ファイルの保持、アーカイブ、クリーンアップは、オブジェクトストレージ側でご自身で管理してください。

• 設定が削除された後、その設定名は再利用可能です。