ApsaraDB RDS:ストアドプロシージャ

使用方法

このトピックのコマンドは SSMS 用で、GO をバッチ コマンド区切り文字として使用します。DMS でストアドプロシージャのコマンドを実行する場合は、GO キーワードを含めないでください。含めると、エラーが発生します。

• データベース統計の更新

• インスタンス内のデータベースのコピー

• データベースのオンライン設定

• グローバルデータベース権限の付与

• データベースの削除

• 変更の追跡の構成

• 変更データ キャプチャの有効化

• 変更データ キャプチャの無効化

• インスタンスパラメータの構成

• リンク サーバーの追加

• トレース フラグの設定

• データベースの名前の変更

• サーバーロールの付与

データベース統計の更新

T-SQL コマンド

sp_rds_update_db_stats

説明

データベース統計を柔軟かつ効率的に更新します。サンプリング率、並列度、タイムアウト、変更のしきい値などのパラメーターを構成できます。

使用方法

-- これは、複数のパラメーターを含む包括的な例です。
-- test_db データベースのデータベース統計を更新します。サンプリング率を 50%、並列度を 4、タイムアウトを 7,200 秒、変更のしきい値を 3 に設定します。
EXEC sp_rds_update_db_stats        
    @db_name = 'test_db',          -- データベース名 (必須)
    @sample_percent = 50,          -- サンプリング率 (オプション)
    @max_dop = 4,                  -- 並列度 (オプション、SQL Server 2012 以前ではサポートされません)
    @timeout_seconds = 7200,       -- タイムアウト (秒) (オプション)
    @modification_threshold = 3;   -- 変更のしきい値 (オプション)

-- データベース名のみを指定します。更新は、Microsoft の sp_updatestats のロジックに従って行われます。
EXEC sp_rds_update_db_stats @db_name = 'test_db';

-- サンプリング率を 30% に設定します。
EXEC sp_rds_update_db_stats 
    @db_name = 'test_db',
    @sample_percent = 30;

-- 最大並列度を 4 に設定します。
EXEC sp_rds_update_db_stats 
    @db_name = 'test_db',
    @max_dop = 4;

-- タイムアウトを 7,200 秒 (2 時間) に設定します。
EXEC sp_rds_update_db_stats 
    @db_name = 'test_db',
    @timeout_seconds = 7200;

インスタンス内のデータベースのコピー

T-SQL コマンド

sp_rds_copy_database

対応エディション

Basic Edition および High-availability Edition

説明

同一インスタンス内にデータベースのコピーを作成します。

使用方法

USE db
GO
EXEC sp_rds_copy_database 'db','db_copy'
GO

• 1 つ目のパラメーターはソースデータベースの名前です。

• 2 つ目のパラメーターは宛先データベースの名前です。

データベースのオンライン化

T-SQL コマンド

sp_rds_set_db_online

対応エディション

RDS Basic Edition および RDS High-availability Edition

説明

データベースを OFFLINE に設定した後は、ALTER DATABASE ステートメントを使用してオンラインに戻すことはできません。代わりに、このストアドプロシージャを使用してください。

使用方法

USE master
GO
EXEC sp_rds_set_db_online 'db'
GO

オンラインにするデータベースの名前を指定します。

グローバルデータベース権限

T-SQL コマンド

sp_rds_set_all_db_privileges

対応インスタンスエディション

Basic Edition、High-availability Edition

説明

使用法

sp_rds_set_all_db_privileges 'user','db_owner','db1,db2...'

• 最初のパラメーターでは、権限を付与されるユーザーを指定します。

• 2 番目のパラメーターでは、ユーザーに付与するデータベースロールを指定します。

• 3 番目のパラメーターでは、カンマで区切って 1 つ以上の対象データベースを指定します。このパラメーターはオプションです。省略した場合、すべてのユーザーデータベースの権限が付与されます。

データベースの削除

T-SQL コマンド

sp_rds_drop_database

対応エディション

High-availability Edition

説明

インスタンスからデータベースを削除します。この操作により、関連するすべてのオブジェクトが削除されます。High-availability Edition インスタンスの場合、この操作によりデータベース ミラーも削除され、データベースへのすべての接続が終了します。

使用方法

USE master
GO
EXEC sp_rds_drop_database 'db'
GO

パラメーターには、削除するデータベースの名前を指定します。

変更の追跡の構成

T-SQL コマンド

sp_rds_change_tracking

対応インスタンスシリーズ

High-availability Edition

説明

データベースの変更の追跡を有効化または無効化します。

使用法

USE db
GO
EXEC sp_rds_change_tracking 'db',1
GO

• 1 つ目のパラメーターはデータベース名です。

• 2 つ目のパラメーターは、変更の追跡を有効化するか無効化するかを指定します。有効な値：

  • 1 ：変更の追跡を有効化します。

  • 0 ：変更の追跡を無効化します。

変更データ キャプチャの有効化

T-SQL コマンド

sp_rds_cdc_enable_db

対応インスタンスシリーズ

High-availability Edition および Cluster Edition

説明

データベースの変更データ キャプチャ (CDC) を有効化します。

使用方法

USE db
GO
-- データベースの CDC を有効化します。
EXEC sp_rds_cdc_enable_db
GO
-- テーブルの CDC を有効化します。
EXEC sys.sp_cdc_enable_table
    @source_schema = '<スキーマ名>',
    @source_name = '<テーブル名>',
    @role_name = '<CDCロール名>'

変更データキャプチャの無効化

T-SQL コマンド

sp_rds_cdc_disable_db

対応インスタンスシリーズ

High-availability Edition、Cluster Edition

説明

データベースの変更データキャプチャ (CDC) を無効にします。

使用方法

USE db
GO
-- データベースレベルで変更データキャプチャ (CDC) を無効にします。
EXEC sp_rds_cdc_disable_db
GO
-- 特定のテーブルの CDC を無効にします。
EXEC sys.sp_cdc_disable_table
    @source_schema = '<スキーマ名>',
    @source_name = '<テーブル名>',
    @capture_instance = '<キャプチャインスタンス名>'
    
-- 特定のテーブルのキャプチャインスタンス名を取得します。
SELECT capture_instance
FROM cdc.change_tables
WHERE source_schema = '<スキーマ名>'
    AND source_name = '<テーブル名>'

RDS インスタンスのパラメータ

T-SQL コマンド

sp_rds_configure

対応インスタンスファミリー

ベーシック版および高可用性版

説明

以下のインスタンスパラメータを設定します。プライマリインスタンスとスタンバイインスタンスの場合、設定が自動的に同期されます。詳細については、Microsoft ドキュメントをご参照ください。

使用法

EXEC sp_rds_configure '<パラメーター>',<値>

• 最初のパラメータは、設定対象のインスタンスパラメータです。

• 2 番目のパラメータは、そのパラメータに設定する値です。

リンク サーバーの追加

T-SQL コマンド

sp_rds_add_linked_server

対応インスタンス

• インスタンスエディション：Cluster Edition および High-availability Edition。 Basic Edition はサポートされていません。

• インスタンスタイプ：汎用および専用。 共有インスタンスはサポートされていません。

• 課金方法：サブスクリプションおよび従量課金。 サーバーレスインスタンス はサポートされていません。

説明

このコマンドはインスタンスにリンク サーバーを追加し、分散トランザクションをサポートします。 プライマリインスタンスで作成されたリンク サーバーは、セカンダリインスタンスに自動的に同期されます。 プライマリ/セカンダリ スイッチオーバー後にリンク サーバーを再設定する必要はありません。 ただし、プライマリインスタンス上の既存のリンク サーバーへの変更は、セカンダリインスタンスには同期されません。 詳細については、「自動または手動のプライマリ/セカンダリ スイッチオーバー」をご参照ください。

使用方法

DECLARE
@linked_server_name sysname = N'yangzhao_slb', -- リンク サーバーの名前。
@data_source sysname = N'****.sqlserver.rds.aliyuncs.com,3888', -- 宛先 SQL Server インスタンスの IP アドレスとポート番号。 形式：IP,Port
@user_name sysname = N'ay15', -- 宛先 SQL Server インスタンスのユーザー名。
@password nvarchar(128) = N'******', -- 宛先のユーザーのパスワード。
@source_user_name sysname = N'test', -- ソースインスタンスのユーザー名。
@source_password nvarchar(128) = N'******', -- ソースのユーザーのパスワード。
-- XML 形式のリンク サーバーのサーバーオプション。 この例では、データアクセス、rpc、および rpc out の権限を設定します。
@link_server_options xml
= N'
      <rds_linked_server>
        <config option="data access">true</config>
        <config option="rpc">true</config>
        <config option="rpc out">true</config>
      </rds_linked_server>
'

EXEC sp_rds_add_linked_server
@linked_server_name,
@data_source,
@user_name,
@password,
@source_user_name,
@source_password,
@link_server_options

トレース フラグの設定

T-SQL コマンド

sp_rds_dbcc_trace

サポートされているエディション

Basic Edition、High-availability Edition

説明

このストアド プロシージャは、RDS インスタンスのトレース フラグを設定します。 現在サポートされているのは、一部のトレース フラグのみです。 プライマリ/セカンダリ インスタンスの場合、この設定はプラットフォームが自動的に同期します。

使用方法

EXEC sp_rds_dbcc_trace '1222',1/0

データベースの名前の変更

USE master
GO
EXEC sp_rds_modify_db_name 'db','new_db'
GO

サーバーロールの付与

T-SQL コマンド

sp_rds_set_server_role

対応エディション

Basic Edition

説明

ログインにサーバーロールを付与します。利用可能なロールは setupadmin と processadmin です。その他の権限を持つアカウントを作成する場合、またはアカウント権限の詳細については、「SA 権限を持つアカウントの作成」および「アカウント権限」をご参照ください。

使用方法

EXEC sp_rds_set_server_role @login_name='test_login',@server_role='setupadmin'

• ログイン名を指定します。

• ロール名を指定します。有効な値は setupadmin と processadmin です。

よくある質問

Q：標準アカウントで EXEC sp_rds_drop_database 'dbtest'; コマンドを実行すると、Cannot use KILL to kill your own process. エラーが発生するのはなぜですか。

A：ターゲットデータベース以外のデータベースに接続したコマンドウィンドウから、特権アカウントを使用してコマンドを実行してください。また、アカウントがターゲットデータベースに対して必要な権限を持っていることを確認してください。詳細については、「アカウント権限の変更」をご参照ください。