データベースクライアントの使用
アプリケーションの問題のトラブルシューティングやカスタム開発のために、データベース内のデータの表示が必要になる場合があります。 データベースにアクセスするには、組み込みのデータベース クライアントを使用してデータベースと直接インターフェースする必要があります。 この機能は Liferay Cloud の最新バージョンで利用でき、数ステップでアクセスできます。
管理者 および 貢献者 権限を持つLiferay Cloudユーザーのみがデータベースクライアントを利用できます。
環境で使用しているデータベースに応じて、 PostgreSQL クライアント または MySQL クライアントのいずれかを使用します。
PostgreSQLクライアント
Liferay サービス経由で PostgreSQL クライアントを使用する前に、サービスを少なくとも以下のサポートされているイメージ バージョンにアップグレードする必要があります。
前提条件
| サービス | サポートされる最小イメージバージョン |
|---|---|
| データベース | liferaycloud/database：5.4.0 |
| ライフレイ（7.4） | liferaycloud/liferay-dxp:7.4-5.5.0 |
| ライフレイ（7.3） | liferaycloud/liferay-dxp:7.3-5.5.0 |
| ライフレイ（7.2） | liferaycloud/liferay-dxp:7.2-5.5.0 |
| ライフレイ（7.1） | liferaycloud/liferay-dxp:7.1-5.5.0 |
PostgreSQLクライアントへのアクセス
-
Liferay Cloudコンソールにログインします。
-
適切な環境に移動し、 ［サービス］をクリックします：
-
liferay サービスをクリックします。
-
シェル タブをクリックします。
-
この画面のシェルに
psqlと入力します。
これにより、PostgreSQL クライアントにログインし、読み取り専用クエリを実行できるようになります。 たとえば、 \dtを実行すると、すべてのテーブルが表示されます。
利用可能なすべてのコマンドについては、公式の PostgreSQL ドキュメント を参照してください。
読み取りおよび書き込み権限でのログイン
デフォルトのユーザーは、データベースに対して読み取りクエリのみを実行でき、データを操作することはできません。 これにより、サービス データを破損する可能性のある偶発的な変更を防ぐことができます。
ただし、データベース内のデータを操作することが 重要 である場合は、シェルに次のコマンドを入力して、データベース資格情報を使用してログインできます ( psqlと入力する代わりに)。
psql -U [LCP_SECRET_DATABASE_USER]
クライアントはパスワードの入力を要求します。 データベース名、ユーザー名、パスワードは、 データベース サービスの シークレットで確認できます。
MySQLクライアントへのアクセス
-
Liferay Cloudコンソールにログインします。
-
適切な環境に移動し、 ［サービス］をクリックします：
-
liferay サービスをクリックします。
-
シェル タブをクリックします。
-
この画面のシェルに
mysqlと入力します。
これにより、MySQLクライアントにログインし、読み取り専用のクエリを実行できます。 たとえば、 show tables;を実行すると、すべてのテーブルを表示できます。
利用可能なすべてのコマンドについては、公式の MySQL クライアントドキュメント を参照してください。
読み取りおよび書き込み権限でのログイン
デフォルトのユーザーは、データベースに対して読み取りクエリのみを実行でき、データを操作することはできません。 これにより、サービス データを破損する可能性のある偶発的な変更を防ぐことができます。
ただし、データベース内のデータを操作することが 重要 である場合は、シェルに次のコマンドを入力して、データベース資格情報を使用してログインできます ( mysqlと入力する代わりに)。
mysql -u [LCP_SECRET_DATABASE_USER] -p
クライアントはパスワードの入力を要求します。 データベース名、ユーザー名、パスワードは、 データベース サービスの シークレットで確認できます。