データベースサービス
データベース サービスは、データベース自体が存在する Google Cloud Platform の Cloud SQL サービスへの Liferay Cloud 内のプロキシです。 データベース サービスは、Cloud SQL インスタンスを管理および監視するためのツールを提供します。 アプリケーションのセットアップ、操作、スケーリングが簡素化されます。 これはアプリケーション環境内のプライベートなサービスであり、公共のインターネットではなく、他のサービスとのみ通信することができます。 Liferay Cloud のデータベースでは、テーブル名と列名は大文字と小文字が区別されます。 Liferay Cloud プロジェクトでは、デフォルトのデータベースとして PostgreSQL 16 がプロビジョニングされます。
詳細については、 データベース サービスの制限事項 を参照してください。
Liferay Cloud のデータベース サービスによって消費されるリソースは、Cloud SQL で消費されるリソースとは別です。
コアデータベース設定とユーザー管理変数
これらの環境変数は、データベースのコア設定と、それにアクセスする主なユーザーに影響します。 これらは、プロジェクトのプロビジョニング中にすでに作成されています。 特定の要件がある場合にのみ変更してください。
LCP_SECRET で始まる値は、Liferay、バックアップ、およびデータベース サービスに公開される秘密変数です。
データベース名、デフォルトの文字セット、または照合順序を変更するには、既存のデータベースを削除し、新しい値でサービスを再起動する必要があり、アプリケーションのダウンタイムが発生します。
詳細については、「 データベース ユーザー名の変更 」および「 データベース パスワードの変更」を参照してください。
| 名前 | デフォルト値 | 設定場所 | 説明 |
|---|---|---|---|
LCP_GCP_DATABASE_CHARSET | PostgreSQL: UTF8; MySQL: utf8mb4 | LCP.json | データベースの文字セット。 通常はこれを変更する必要はありません。 |
LCP_GCP_DATABASE_COLLATION | PostgreSQL: en_US.UTF-8; MySQL: utf8mb4_unicode_ci | LCP.json | データベースの照合。 これは、並べ替え順序に関する特定の要件がある場合にのみ変更する必要があります。 |
LCP_SECRET_DATABASE_NAME | lportal | シークレット (lcp-secret-database-name) | データベース名 |
LCP_SECRET_DATABASE_PASSWORD | （ランダム値） | シークレット (lcp-secret-database-password) | マスターパスワード |
LCP_SECRET_DATABASE_READONLY_USER | （環境名） | シークレット lcp-secret-database-readonly-user | 読み取り専用のユーザー名 (データベース クライアント接続用)。 |
LCP_SECRET_DATABASE_READONLY_USER_PASSWORD | （ランダム値） | シークレット lcp-secret-database-readonly-user-password | 読み取り専用ユーザー パスワード。 |
LCP_SECRET_DATABASE_USER | dxpcloud | シークレット (lcp-secret-database-user) | マスターユーザー名 |
LCP_DATABASE_USER_WHITELIST | なし | LCP.json | データベース サービスによって自動的に削除されないように、追加のユーザーをホワイトリストに追加します。 |
LCP_SERVICE_LOG_LEVEL | INFO | LCP.json | 表示するログ メッセージの最低優先度レベル。 ログレベルの名前または数値を設定します。 詳細については、 ログ レベル を参照してください。 |
データベースメンテナンスウィンドウの変数
Liferay Cloud 環境のデータベース サービスでは、定期メンテナンスのためにダウンタイム (通常は約 2 分) が必要になることがあります。 ダウンタイムの影響を軽減するために、このメンテナンスを実行する優先ウィンドウを設定できます。 デフォルトでは、特定の日時は決められていません。
| 名前 | 許容値 | 説明 |
|---|---|---|
LCP_GCP_MW_DAY | 1 から 7 | 希望する曜日（月（1）〜日（7）、UTC時間）。 |
LCP_GCP_MW_HOUR | 0 から 23 | 希望する時間帯（UTC時間）。 |
LCP_GCP_MW_UPDATE_TRACK | カナリア、 安定版 | canary を設定して、他の環境より最大で1週間早く更新します。 |
Google Cloud PostgreSQL フラグ
MySQLのフラグを環境変数として渡すことができます。 使用可能なフラグは、 Google Cloud ドキュメントに記載されています。 Liferay Cloud で機能するには、各フラグの先頭に LCP_GCP_DATABASE_FLAG_ を追加する必要があります。 以下は、開発環境でのデバッグに役立つ一般的なフラグですが、本番環境ではパフォーマンスに大きな影響を与えるため、使用しないでください。
Googleのドキュメントに記載されているように、一部のデータベース フラグ設定はインスタンスの可用性や安定性に影響を及ぼす可能性があります。 これらのフラグを使用するときは注意し、Googleの 運用ガイドラインに従ってください。
Google Cloud MySQL フラグ
MySQLのフラグを環境変数として渡すことができます。 使用可能なフラグは、 Google Cloud ドキュメントに記載されています。 Liferay Cloud で機能するには、各フラグの先頭に LCP_GCP_DATABASE_FLAG_ を追加する必要があります。 開発環境でのデバッグに役立つ一般的なフラグを次に示します。 パフォーマンスコストが大幅に高まるため、実稼働環境では使用しないでください。
| 名前 | 許容値 | デフォルト値 |
|---|---|---|
LCP_GCP_DATABASE_FLAG_GENERAL_LOG | on, off | off |
LCP_GCP_DATABASE_FLAG_SLOW_QUERY_LOG | on, off | off |
max_allowed_packet プロパティを使用してペイロードのサイズを制限することもできます。 高く設定しすぎると、メモリ消費量が増える可能性があります。 設定値が低すぎると、クエリが失敗し、ペイロードが大きい場合の接続が失われる可能性があります。
| 名前 | 許容値 | デフォルト値 |
|---|---|---|
LCP_GCP_DATABASE_FLAG_MAX_ALLOWED_PACKET | 1024の倍数 | 268435456 |
Googleのドキュメントに記載されているように、一部のデータベース フラグ設定はインスタンスの可用性や安定性に影響を与える可能性があります。 これらのフラグを使用するときは注意し、Googleの 運用ガイドラインに従ってください。