ALTER SUBSCRIPTION

PostgreSQL 17.0文書
		SQLコマンド
前へ	上へ	ALTER SUBSCRIPTION	次へ

ALTER SUBSCRIPTION — サブスクリプションの定義を変更する

概要

ALTER SUBSCRIPTION name CONNECTION 'conninfo'
ALTER SUBSCRIPTION name SET PUBLICATION publication_name [, ...] [ WITH ( publication_option [= value] [, ... ] ) ]
ALTER SUBSCRIPTION name ADD PUBLICATION publication_name [, ...] [ WITH ( publication_option [= value] [, ... ] ) ]
ALTER SUBSCRIPTION name DROP PUBLICATION publication_name [, ...] [ WITH ( publication_option [= value] [, ... ] ) ]
ALTER SUBSCRIPTION name REFRESH PUBLICATION [ WITH ( refresh_option [= value] [, ... ] ) ]
ALTER SUBSCRIPTION name ENABLE
ALTER SUBSCRIPTION name DISABLE
ALTER SUBSCRIPTION name SET ( subscription_parameter [= value] [, ... ] )
ALTER SUBSCRIPTION name SKIP ( skip_option = value )
ALTER SUBSCRIPTION name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER SUBSCRIPTION name RENAME TO new_name

説明

ALTER SUBSCRIPTIONはCREATE SUBSCRIPTIONで指定できるサブスクリプションの属性のほとんどを変更できます。

ALTER SUBSCRIPTIONを使用するには、そのサブスクリプションを所有していなければなりません。サブスクリプションの名前を変更したり、所有者を変更したりするには、データベースに対するCREATE権限が必要です。さらに、所有者を変更するには、新しい所有者ロールに対してSET ROLEができなければなりません。所有者を変更するには、また、そのロールは型のスキーマにおいてCREATE権限を持たなければなりません。サブスクリプションがpassword_required=falseである場合、スーパーユーザのみが変更できます。

パブリケーションを更新するときには、もうパブリケーションの一部ではないリレーションを削除し、存在すればテーブル同期スロットも削除します。リモートホストでサブスクリプションのために割り当てられたリソースを解放するために、これらのスロットを解放することが必要です。ネットワーク切れやその他のエラーによりPostgreSQLがスロットを削除できなかった場合、エラーが報告されます。この状況で処理を進めるためには、ユーザは操作を再度試みるか、または、スロットをサブスクリプションから切り離し、DROP SUBSCRIPTIONで説明するようサブスクリプションを削除することが必要です。

コマンドALTER SUBSCRIPTION ... REFRESH PUBLICATIONとrefreshオプションがtrueのALTER SUBSCRIPTION ... {SET|ADD|DROP} PUBLICATION ...、そしてALTER SUBSCRIPTION ... SET (failover = true|false)は、トランザクションブロック内では実行できません。

サブスクリプションがtwo_phaseコミットを有効にしている場合でも、copy_dataがfalseでない限り、コマンドALTER SUBSCRIPTION ... REFRESH PUBLICATIONとrefreshオプションがtrueのALTER SUBSCRIPTION ... {SET|ADD|DROP} PUBLICATION ...は実行できません。実際の2相状態を知るには、pg_subscriptionのsubtwophasestate列を参照してください。

パラメータ

name #

属性の変更の対象となるサブスクリプションの名前です。

CONNECTION 'conninfo' #

この句では、元はCREATE SUBSCRIPTIONにより設定された接続文字列を置き換えます。詳細な情報はそちらを参照してください。

SET PUBLICATION publication_name ADD PUBLICATION publication_name DROP PUBLICATION publication_name #

この形式はサブスクライブするパブリケーションのリストを変更します。 SETはパブリケーションのリスト全体を新しいリストで置き換え、ADDは追加のパブリケーションをパブリケーションのリストに追加し、DROPはパブリケーションをパブリケーションのリストから削除します。ユーザが後から追加できるよう存在しないパブリケーションをADDやSETで指定することを許容します。詳細はCREATE SUBSCRIPTIONを参照してください。デフォルトでは、このコマンドはREFRESH PUBLICATIONのような動作もします。

publication_optionは、この操作についての追加のオプションを指定します。以下のオプションがサポートされています。

refresh (boolean): falseにすると、このコマンドはテーブルを情報を更新しません。後で別にREFRESH PUBLICATIONを実行することになります。デフォルトはtrueです。

さらに、暗黙の更新動作を制御するためにREFRESH PUBLICATIONの項で説明されているオプションを指定できます。

REFRESH PUBLICATION #

不足しているテーブル情報をパブリッシャーから取得します。 CREATE SUBSCRIPTION、あるいは最後のREFRESH PUBLICATIONの実行の後でサブスクライブ対象のパブリケーションに追加されたテーブルの複製が、これにより開始されます。

refresh_optionは更新(refresh)の操作について追加のオプションを指定します。以下のオプションがサポートされています。

copy_data (boolean)

サブスクライブ対象のパブリケーションにある既存のデータが、レプリケーションの開始時にコピーされるかどうかを指定します。デフォルトはtrueです。

テーブルの行フィルタWHERE句が変更されていても、以前にサブスクライブされたテーブルはコピーされません。

copy_data = trueがoriginパラメータとどのように相互作用するかの詳細については、注釈を参照してください。

バイナリ形式の既存のデータをコピーする詳細については、CREATE SUBSCRIPTIONのbinaryパラメータを参照してください。

ENABLE #

以前に無効化されたサブスクリプションを有効化し、トランザクションの終了時に論理レプリケーションワーカーを起動します。

DISABLE #

実行中のサブスクリプションを無効化し、トランザクションの終了時に論理レプリケーションワーカーを停止します。

SET ( subscription_parameter [= value] [, ... ] ) #

この句では、元はCREATE SUBSCRIPTIONにより設定されたパラメータを変更します。詳細な情報はそちらを参照してください。変更できるパラメータは、 slot_name、 synchronous_commit、 binary、 streaming、 disable_on_error、 password_required、 run_as_owner、 origin、 failover です。スーパーユーザだけがpassword_required = falseを設定できます。

slot_nameを変更する際、指定されたスロットのfailoverとtwo_phaseの値が、サブスクリプションで指定された対応するfailoverおよびtwo_phaseパラメータと異なる可能性があります。スロットを作成する際、スロットプロパティのfailoverおよびtwo_phaseが対応するサブスクリプションパラメータと一致することを確認してください。そうしないと、パブリッシャー上のスロットがこれらサブスクリプションオプションで指定されている内容とは異なる動作をする場合があります。例えば、サブスクリプションオプションのfailoverが無効になっていても、パブリッシャー上のスロットがスタンバイと同期されたり、逆にサブスクリプションオプションのfailoverが有効になっている場合でも、同期が行われなかったりする可能性があります。

SKIP ( skip_option = value ) #

リモートトランザクションのすべての変更の適用をスキップします。受信データが何らかの制約に違反している場合、解決されるまで論理レプリケーションは停止します。 ALTER SUBSCRIPTION ... SKIPコマンドを使用すると、論理レプリケーションワーカーはトランザクション内のすべてのデータ修正変更をスキップします。このオプションは、サブスクライバーでtwo_phaseを有効にしてすでに準備されているトランザクションには影響しません。論理レプリケーションワーカーがトランザクションをスキップするかトランザクションを終了ことに成功した後、LSN(pg_subscription.subskiplsnに格納されています)がクリアされます。論理レプリケーションの競合の詳細については29.6を参照してください。

skip_optionは、この操作のオプションを指定します。サポートされているオプションは以下の通りです。

lsn (pg_lsn): 論理レプリケーションワーカーによって変更がスキップされるリモートトランザクションの終了LSNを指定します。終了LSNは、トランザクションがコミットまたは準備されるLSNです。個々のサブトランザクションのスキップはサポートされません。 NONEを設定すると、LSNがリセットされます。

new_owner #

サブスクリプションの新しい所有者のユーザ名です。

new_name #

サブスクリプションの新しい名前です。

boolean型のパラメータを指定する場合、= valueの部分を省略できます。これはTRUEを指定するのと同じです。

例

サブスクリプションがサブスクライブするパブリケーションをinsert_onlyに変更します。

ALTER SUBSCRIPTION mysub SET PUBLICATION insert_only;

サブスクリプションを無効化（停止）します。

ALTER SUBSCRIPTION mysub DISABLE;

互換性

ALTER SUBSCRIPTIONはPostgreSQLの拡張です。

ALTER SUBSCRIPTION

概要

説明

パラメータ

例

互換性

関連項目