ALTER DATABASE - Amazon Redshift

ALTER DATABASE

データベースの属性を変更します。

必要な権限

ALTER DATABASE を使用するには、次の権限のいずれかが必要です。

  • スーパーユーザー

  • ALTER DATASHARE 権限を持つユーザー

  • データベースの所有者

構文

ALTER DATABASE database_name { RENAME TO new_name | OWNER TO new_owner | CONNECTION LIMIT { limit | UNLIMITED } | COLLATE { CASE_SENSITIVE | CASE_INSENSITIVE } | ISOLATION LEVEL { SERIALIZABLE | SNAPSHOT } | INTEGRATION REFRESH {{ ALL | INERROR } TABLES [IN SCHEMA schema [, ...]] | TABLE schema.table [, ...]} }

パラメータ

database_name

変更するデータベースの名前。通常、現在接続されていないデータベースを変更します。いずれの場合も、変更は後のセッションにのみ反映されます。現在のデータベースの所有者を変更できますが、名前を変更することはできません。

alter database tickit rename to newtickit; ERROR: current database may not be renamed
RENAME TO

指定したデータベースの名前を変更します。有効な名前の詳細については、「名前と識別子」を参照してください。dev、padb_harvest、template0、template1、または sys:internal の各データベースの名前を変更することはできません。また、現在のデータベースの名前も変更できません。データベース所有者またはsuperuserのみがデータベース名を変更できます。スーパーユーザー以外の所有者には CREATEDB 権限も必要です。

new_name

新しいデータベース名。

OWNER TO

指定したデータベースの所有者を変更します。現在のデータベースまたは他のデータベースの所有者を変更できます。スーパーユーザーのみが所有者を変更できます。

new_owner

新しいデータベース所有者。新しい所有者は、書き込み権限を持つ既存のデータベースユーザーであることが必要です。ユーザー権限の詳細については、GRANTを参照してください。

CONNECTION LIMIT { limit | UNLIMITED }

ユーザーが同時に開けるデータベース接続の最大数。この制限はスーパーユーザーには適用されません。同時接続の最大数を許可するには、UNLIMITED キーワードを使用します。ユーザーごとの接続数の制限が適用される場合もあります。詳細については、「CREATE USER」を参照してください。デフォルトは UNLIMITED です。現在の接続を確認するには、STV_SESSIONSシステムビューに対してクエリを実行します。

注記

ユーザーとデータベースの両方の接続制限が適用される場合は、ユーザーが接続しようとしたときに、両方の制限内に未使用の接続スロットがなければなりません。

COLLATE { CASE_SENSITIVE | CASE_INSENSITIVE }

文字列の検索または比較において、大文字と小文字を区別するか、あるいは区別しないかを指定する句。

現在、空の状態のデータベースでは、大文字と小文字を区別するかどうかの設定を変更することができます。

大文字と小文字の区別を変更するには、そのデータベースに対する権限が必要です。CREATE DATABASE 権限を持つスーパーユーザーまたはデータベース所有者も、データベースで大文字と小文字を区別するかどうかを設定できます。

ISOLATION LEVEL { SERIALIZABLE | SNAPSHOT }

データベースに対してクエリを実行するときに使用される分離レベルを指定する句。

  • 直列化可能な分離 – 同時トランザクションの完全な直列化機能を提供します。詳細については、「直列化可能分離」を参照してください。

  • スナップショットの分離 – 更新および削除の競合に対する保護機能を備えた分離レベルを提供します。

分離レベルの詳細については、「CREATE DATABASE」を参照してください。

データベースの分離レベルを変更するときは、以下の点を考慮します。

  • データベースの分離レベルを変更するには、スーパーユーザー権限または CREATE DATABASE 権限が必要です。

  • dev データベースの分離レベルは変更できません。

  • トランザクションブロック内の分離レベルは変更できません。

  • 他のユーザーがデータベースに接続している場合、分離レベルの変更コマンドは失敗します。

  • 分離レベルの変更コマンドでは、現在のセッションの分離レベルの設定を変更できます。

INTEGRATION REFRESH {{ ALL | INERROR } TABLES [IN SCHEMA schema [, ...]] | TABLE schema.table [, ...]}

Amazon Redshift がすべてのテーブルを更新するか、あるいは指定されたスキーマやテーブル内でエラーのあるテーブルを更新するかどうかを指定する句。更新によって、指定されたスキーマやテーブル内のテーブルはソースデータベースから完全に複製されます。

詳細については、「Amazon Redshift 管理ガイド」の「ゼロ ETL 統合での作業」を参照してください。統合の状態の詳細については、「SVV_INTEGRATION_TABLE_STATE」と「SVV_INTEGRATION」を参照してください。

使用に関する注意事項

ALTER DATABASE コマンドは現在のセッションではなく、後のセッションに適用されます。変更の反映を確認するには、変更されたデータベースに再接続する必要があります。

次の例では、TICKIT_SANDBOX という名前のデータベースを TICKIT_TEST に変更します。

alter database tickit_sandbox rename to tickit_test;

次の例では、TICKIT データベース (現在のデータベース) の所有者を DWUSER に変更します。

alter database tickit owner to dwuser;

次の例では、sampledb データベースで大文字小文字を区別するかどうかの設定を変更しています。

ALTER DATABASE sampledb COLLATE CASE_INSENSITIVE;

次の例では、スナップショット分離レベルを使用して sampledb という名前のデータベースを変更します。

ALTER DATABASE sampledb ISOLATION LEVEL SNAPSHOT;

次の例では、ゼロ ETL 統合で、データベース sample_integration_db 内のテーブル sample_table1sample_table2 を更新します。

ALTER DATABASE sample_integration_db INTEGRATION REFRESH TABLES sample_table1, sample_table2;

次の例では、ゼロ ETL 統合で同期されたテーブルと失敗したテーブルをすべて更新します。

ALTER DATABASE sample_integration_db INTEGRATION REFRESH ALL tables;

次の例では、スキーマ sample_schema 内で ErrorState となっているテーブルをすべて更新します。

ALTER DATABASE INTEGRATION REFRESH IN ERROR TABLES in SCHEMA sample_schema;