PostgreSQL ユーザーの作成、管理

MySQL | PostgreSQL | SQL Server

このページでは、Cloud SQL インスタンスに対して次の操作を行う方法について説明します。

デフォルトのユーザーアカウントを構成します。
他のユーザーアカウントを作成、削除、更新します。

Cloud SQL でのユーザーの詳細については、PostgreSQL ユーザーをご覧ください。

始める前に

以下のタスクを完了する前に、Cloud SQL インスタンスを作成します。詳細については、インスタンスの作成をご覧ください。

データベースの管理クライアントを使用してユーザーを管理する場合は、インスタンスでデフォルトユーザーを構成しておく必要があります。詳細については、デフォルトアカウントの構成をご覧ください。

また、インスタンスに接続された管理クライアントを構成しておく必要があります。詳細については、外部アプリケーションのための接続オプションをご覧ください。

デフォルトユーザーアカウントの構成

新しい Cloud SQL インスタンスを作成する場合、インスタンスに接続するには、デフォルトユーザーアカウントを構成しておく必要があります。

Cloud SQL for PostgreSQL の場合、デフォルトのユーザーは postgres です。

デフォルトユーザーを構成するには:

Console

Google Cloud Console の Cloud SQL インスタンスページに移動します。
[Cloud SQL インスタンス] ページに移動
インスタンスをクリックして [概要] ページを開きます。
ナビゲーションメニューから [ユーザー] を選択します。
postgres ユーザーを検索し、その他の操作メニューから [パスワードを変更] を選択します。
覚えやすく強力なパスワードを指定し、[OK] をクリックします。

gcloud

デフォルトユーザーのパスワードを設定します。

gcloud sql users set-password postgres \
    --instance=[INSTANCE_NAME] --prompt-for-password

REST

以下のリクエストでは、users:update メソッドを使用して postgres ユーザーを更新します。

gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{"name": "postgres", "password": "[PASSWORD]"}' \
     -X PUT \
     'https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]/users?name=postgres&'

ユーザーの作成

ユーザーを作成するには:

Console

Google Cloud Console の Cloud SQL インスタンスページに移動します。
[Cloud SQL インスタンス] ページに移動
インスタンスを選択して [概要] ページを開きます。
ナビゲーションメニューから [ユーザー] を選択します。
[ユーザーの追加] をクリックします。
[ユーザーアカウントをインスタンス instance_name に追加] ページで、[PostgreSQL] ラジオボタンをクリックします。
以下の情報を追加します。
- ユーザー名
- パスワード
- ホスト（オプション）
  
  デフォルトは '%' です。これは、ホストリストが制限されていないことを意味します。IP アドレスまたは IP アドレスの範囲を指定することもできます。この場合、これらのアドレスから接続しているユーザーだけがデータベースにアクセスできます。
[作成] をクリックします。

Cloud SQL を使用して作成されたユーザーには、cloudsqlsuperuser ロールと関連付けられている権限（CREATEROLE、CREATEDB、LOGIN）があります。これらのユーザーによって作成されたユーザーは、データベース接続権限を持つことができます。これにより、ユーザーが削除されるのを防ぐことができます。ユーザーの属性を変更する必要がある場合は、psql クライアントで ALTER ROLE コマンドを使用します。ALTER ROLE で変更できない属性もあります。ただし、NOSUPERUSER ロールと NOREPLICATION ロールは例外です。

gcloud

ユーザーを作成します。

gcloud sql users create [USER_NAME] \
   --instance=[INSTANCE_NAME] --password=[PASSWORD]

ユーザー名の長さの上限は、オンプレミス PostgreSQL の場合と同じです。

REST

以下のリクエストでは、users:insert メソッドを使用してユーザーアカウント（user_name）を作成します。

gcloud auth application-default login
ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{"name": "[USER_NAME]", "password": "[PASSWORD]"}' \
     -X POST \
     https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]/users

ユーザー名の長さの上限は、オンプレミス PostgreSQL の場合と同じです。

psql クライアント

psql プロンプトで、ユーザーを作成します。
```
  CREATE USER [USER_NAME]
      WITH [ATTRIBUTE1] [ATTRIBUTE2]...;
      \password [USER_NAME];
  
```
プロンプトが表示されたら、パスワードを入力します。

役割の属性に関する詳細については、PostgreSQL のドキュメントをご覧ください。

注: EXTENSION pg_stat_statements を使用する場合、すべてのユーザーから送られた SQL ステートメントは cloudsqlsuperuser ロールを持つユーザーに表示されます（PostgreSQL バージョン 10 以降）。クエリでは、書式なしテキストのパスワードを使用しないでください。
ユーザーテーブルを表示することによって、ユーザーの作成を確認できます。
```
  SELECT * FROM pg_roles;
  
```

ユーザーのパスワードの変更

ユーザーのパスワードを変更するには:

Console

Google Cloud Console の Cloud SQL インスタンスページに移動します。
[Cloud SQL インスタンス] ページに移動
インスタンスを選択して [概要] ページを開きます。
ナビゲーションメニューから [ユーザー] を選択します。
更新するユーザーのその他アイコンをクリックします。
[パスワードを変更] を選択し、新しいパスワードを指定して、[OK] をクリックします。

gcloud

パスワードを更新します。

gcloud sql users set-password [USER_NAME] \
   --instance=[INSTANCE_NAME] --prompt-for-password

REST

以下のリクエストでは、users:update メソッドを使用して、ユーザーアカウント（user_name）のパスワードを更新します。

gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{"name": "[USER_NAME]", "password": "[PASSWORD]"}' \
     -X PUT \
     'https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]/users?name=[USER_NAME]'

psql クライアント

psql プロンプトで、パスワードを変更します。
```
\password [USER];
```
プロンプトが表示されたら、パスワードを入力します。

注: EXTENSION pg_stat_statements を使用する場合、すべてのユーザーから送られた SQL ステートメントは cloudsqlsuperuser ロールを持つユーザーに表示されます（PostgreSQL バージョン 10 以降）。クエリでは、書式なしテキストのパスワードを使用しないでください。

ユーザーの更新

属性などのユーザープロパティを更新するには、psql クライアントを使用する必要があります。詳細については、PostgreSQL ドキュメントのデータベースの役割をご覧ください。

注: EXTENSION pg_stat_statements を使用する場合、すべてのユーザーから送られた SQL ステートメントは cloudsqlsuperuser ロールを持つユーザーに表示されます（PostgreSQL バージョン 10 以降）。クエリでは、書式なしテキストのパスワードを使用しないでください。

ユーザーの一覧を表示する

ユーザーを一覧表示するには:

Console

Google Cloud Console の Cloud SQL インスタンスページに移動します。
[Cloud SQL インスタンス] ページに移動
インスタンスを選択して [概要] ページを開きます。
ナビゲーションメニューから [ユーザー] を選択します。

gcloud

このインスタンスのユーザーを一覧表示します。

gcloud sql users list --instance=[INSTANCE_NAME]

このコマンドのパラメータの完全なリストについては、gcloud sql users list のリファレンスページをご覧ください。

REST

次のリクエストでは、users:list メソッドを使用して、インスタンスに定義されているユーザーを一覧表示します。

gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     -X GET \
     https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]/users

psql クライアント

psql プロンプトで、PostgreSQL ユーザーの一覧を表示します。

SELECT * FROM pg_roles;

ユーザーの削除

ユーザーを削除するには:

ユーザーを削除する前に、そのユーザーが所有するすべてのオブジェクトを削除するか、ユーザーの所有権の割り当てを変更して、他のオブジェクトにロールが付与されている権限をすべて取り消す必要があります。

Console

Google Cloud Console の Cloud SQL インスタンスページに移動します。
[Cloud SQL インスタンス] ページに移動
インスタンスを選択して [概要] ページを開きます。
ナビゲーションメニューから [ユーザー] を選択します。
削除するユーザーのその他アイコンをクリックします。
[削除] を選択し、[OK] をクリックします。

gcloud

ユーザーを削除します。

gcloud sql users delete [USER_NAME] --instance=[INSTANCE_NAME]

REST

以下のリクエストでは、users:delete メソッドを使用して、指定されたユーザーアカウントを削除します。

gcloud auth application-default login
ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{"name": "[USER_NAME]", "host": ""}' \
     -X DELETE \
     'https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]/users?host=&name=[USER_NAME]'

psql クライアント

psql プロンプトで、ユーザーを削除します。
```
DROP ROLE [USER_NAME];
```
DROP ROLE ステートメントの詳細については、PostgreSQL のドキュメントをご覧ください。

PostgreSQL ユーザーの作成、管理

始める前に

デフォルト ユーザー アカウントの構成

Console

gcloud

REST

ユーザーの作成

Console

gcloud

REST

psql クライアント

ユーザーのパスワードの変更

Console

gcloud

REST

psql クライアント

ユーザーの更新

ユーザーの一覧を表示する

Console

gcloud

REST

psql クライアント

ユーザーの削除

Console

gcloud

REST

psql クライアント

次のステップ

デフォルトユーザーアカウントの構成