データベースサービス

このデータベースサービスは、Liferay Cloud 内のプロキシとして機能し、データベース自体が存在する Google Cloud Platform 内の Cloud SQL サービスに接続します。 データベースサービスは、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	表示するログメッセージの優先度が最も低いレベル。 ログレベルの名前または数値を設定します。 詳細については、 ログレベル を参照してください。

データベースメンテナンスウィンドウの変数

ご利用のデータベースサービスのCloud SQLインスタンスは、定期メンテナンスのため、通常2分程度の短時間の停止が必要となる場合があります。 アプリケーションへの影響を軽減するために、優先ウィンドウを設定できます。 値が設定されていない場合、メンテナンス期間は自動的に割り当てられます。

このメンテナンスは、データベース サービスを含む Liferay Cloud プラットフォーム — に適用される Liferay Cloud Platform メンテナンス ウィンドウとは別です。

名前	許容値	説明
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 の 運用ガイドライン に従ってください。

関連トピック

• データベースのユーザー名の変更
• データベースパスワードの変更
• データベースサービスの制限事項
• データベースクライアントの使用