ApsaraDB RDS:Stored procedures

Uso

Os comandos neste tópico são para o SSMS e usam GO como separador de comandos em lote. Ao executar comandos de procedimentos armazenados no DMS, não inclua a palavra-chave GO. Caso contrário, ocorrerá um erro.

• Atualizar estatísticas do banco de dados

• Copiar um banco de dados dentro de uma instância

• Colocar um banco de dados online

• Permissões globais de banco de dados

• Excluir um banco de dados

• Configurar o controle de alterações

• Ativar o change data capture

• Desativar o change data capture

• Parâmetros da instância RDS

• Adicionar um servidor vinculado

• Configurar um trace flag

• Renomear um banco de dados

• Conceder funções de servidor

Atualizar estatísticas do banco de dados

Comando T-SQL

sp_rds_update_db_stats

Descrição

Atualiza as estatísticas do banco de dados de forma flexível e eficiente, permitindo a configuração de parâmetros como taxa de amostragem, grau de paralelismo, tempo limite e limiar de modificação.

Uso

-- This is a comprehensive example that includes multiple parameters.
-- Update database statistics for the test_db database. Set the sampling rate to 50%, the degree of parallelism to 4, the timeout to 7,200 seconds, and the modification threshold to 3.
EXEC sp_rds_update_db_stats        
    @db_name = 'test_db',          -- Database name (required)
    @sample_percent = 50,          -- Sampling rate (optional)
    @max_dop = 4,                  -- Degree of parallelism (optional, not supported in SQL Server 2012 and earlier)
    @timeout_seconds = 7200,       -- Timeout in seconds (optional)
    @modification_threshold = 3;   -- Modification threshold (optional)

-- Specify only the database name. The update follows the logic of Microsoft's sp_updatestats.
EXEC sp_rds_update_db_stats @db_name = 'test_db';

-- Set the sampling rate to 30%.
EXEC sp_rds_update_db_stats 
    @db_name = 'test_db',
    @sample_percent = 30;

-- Set the maximum degree of parallelism to 4.
    EXEC sp_rds_update_db_stats 
        @db_name = 'test_db',
        @max_dop = 4;

-- Set the timeout to 7,200 seconds (2 hours).
    EXEC sp_rds_update_db_stats 
     @db_name = 'test_db',
     @timeout_seconds = 7200;

Copiar um banco de dados dentro de uma instância

Comando T-SQL

sp_rds_copy_database

Edições suportadas

Basic Edition e High-availability Edition

Descrição

Cria uma cópia de um banco de dados dentro da mesma instância.

Uso

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

• Primeiro parâmetro: o nome do banco de dados de origem.

• Segundo parâmetro: o nome do banco de dados de destino.

Colocar um banco de dados online

Comando T-SQL

sp_rds_set_db_online

Edições suportadas

RDS Basic Edition e RDS High-availability Edition

Descrição

Após definir um banco de dados como OFFLINE, não é possível usar a instrução ALTER DATABASE para colocá-lo online novamente. Em vez disso, use este procedimento armazenado.

Uso

USE master
GO
EXEC sp_rds_set_db_online 'db'
GO

Nome do banco de dados a ser colocado online.

Permissões globais de banco de dados

Comando T-SQL

sp_rds_set_all_db_privileges

Edições de instância suportadas

Basic Edition, High-availability Edition

Descrição

Uso

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

• Primeiro parâmetro: o usuário que receberá as permissões.

• Segundo parâmetro: a função de banco de dados a ser concedida ao usuário.

• Terceiro parâmetro: um ou mais bancos de dados de destino, separados por vírgulas. Este parâmetro é opcional. Omiti-lo concede permissões em todos os bancos de dados de usuário.

Excluir um banco de dados

Comando T-SQL

sp_rds_drop_database

Edições suportadas

High-availability Edition

Descrição

Exclui um banco de dados de uma instância, removendo todos os objetos associados. Para instâncias da High-availability Edition, esta operação também remove o espelhamento do banco de dados e encerra todas as conexões com ele.

Uso

USE master
GO
EXEC sp_rds_drop_database 'db'
GO

O parâmetro especifica o nome do banco de dados a ser excluído.

Configurar o controle de alterações

Comando T-SQL

sp_rds_change_tracking

Séries de instância suportadas

High-availability Edition

Descrição

Ativa ou desativa o controle de alterações para um banco de dados.

Uso

USE db
GO
EXEC sp_rds_change_tracking 'db',1
GO

• Primeiro parâmetro: o nome do banco de dados.

• Segundo parâmetro: especifica se deve ativar ou desativar o controle de alterações. Valores válidos:

  • 1: Ativa o controle de alterações.

  • 0: Desativa o controle de alterações.

Ativar o change data capture

Comando T-SQL

sp_rds_cdc_enable_db

Séries de instância suportadas

High-availability Edition e Cluster Edition

Descrição

Ativa o change data capture (CDC) para um banco de dados.

Uso

USE db
GO
-- Enable CDC for a database.
EXEC sp_rds_cdc_enable_db
GO
-- Enable CDC for a table.
EXEC sys.sp_cdc_enable_table
    @source_schema = '<schema name>',
    @source_name = '<table name>',
    @role_name = '<CDC role name>'

Desativar o change data capture

Comando T-SQL

sp_rds_cdc_disable_db

Séries de instância suportadas

High-availability Edition, Cluster Edition

Descrição

Desativa o change data capture (CDC) para um banco de dados.

Uso

USE db
GO
-- Disable change data capture (CDC) at the database level.
EXEC sp_rds_cdc_disable_db
GO
-- Disable CDC for a specific table.
EXEC sys.sp_cdc_disable_table
    @source_schema = '<schema_name>',
    @source_name = '<table_name>',
    @capture_instance = '<capture_instance_name>'
    
-- Get the capture instance name for a specific table.
SELECT capture_instance
FROM cdc.change_tables
WHERE source_schema = '<schema_name>'
    AND source_name = '<table_name>'

Parâmetros da instância RDS

Comando T-SQL

sp_rds_configure

Famílias de instância suportadas

Basic Edition e High-availability Edition

Descrição

Configure os seguintes parâmetros da instância. Em instâncias primárias e secundárias, as configurações são sincronizadas automaticamente. Para obter mais detalhes, consulte a documentação da Microsoft.

Uso

EXEC sp_rds_configure '<parameter>',<parameter value>

• Primeiro parâmetro: o parâmetro de configuração da instância a ser definido.

• Segundo parâmetro: o valor do parâmetro.

Adicionar um servidor vinculado

Comando T-SQL

sp_rds_add_linked_server

Instâncias suportadas

• Edição da instância: Cluster Edition e High-availability Edition. A Basic Edition não é suportada.

• Tipo de instância: uso geral e dedicada. Instâncias shared não são suportadas.

• Método de faturamento: assinatura e pagamento conforme o uso. serverless instances não são suportados.

Descrição

Este comando adiciona um servidor vinculado a uma instância e oferece suporte a transações distribuídas. Um servidor vinculado criado na instância primária é sincronizado automaticamente com a instância secundária. Não é necessário reconfigurar o servidor vinculado após um failover primário/secundário. No entanto, as modificações nos servidores vinculados existentes na instância primária não são sincronizadas com a instância secundária. Para obter mais informações, consulte Failover primário/secundário automático ou manual.

Uso

DECLARE
@linked_server_name sysname = N'yangzhao_slb', --The name of the linked server.
@data_source sysname = N'****.sqlserver.rds.aliyuncs.com,3888', --The IP address and port number of the destination SQL Server instance. Format: IP,Port
@user_name sysname = N'ay15' , --The username for the destination SQL Server instance.
@password nvarchar(128) = N'******', --The password for the destination user.
@source_user_name sysname = N'test', --The username on the source instance.
@source_password nvarchar(128) = N'******', --The password for the source user.
--Server options for the linked server in XML format. This example sets permissions for data access, rpc, and 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

Configurar um trace flag

Comando T-SQL

sp_rds_dbcc_trace

Edições suportadas

Basic Edition, High-availability Edition

Descrição

Este procedimento armazenado define um trace flag para uma instância RDS. Atualmente, oferece suporte apenas a um subconjunto de trace flags. Para instâncias primárias e secundárias, a plataforma sincroniza essa configuração automaticamente.

Uso

EXEC sp_rds_dbcc_trace '1222',1/0

Renomear um banco de dados

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

Conceder funções de servidor

Comando T-SQL

sp_rds_set_server_role

Edições suportadas

Basic Edition

Descrição

Concede uma função de servidor a um login. As funções disponíveis são setupadmin e processadmin. Para criar contas com outras permissões ou para saber mais sobre as permissões de conta, consulte Criar uma conta com permissões SA e Permissões da conta.

Uso

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

• Nome do login.

• Nome da função. Os valores válidos são setupadmin e processadmin.

Perguntas frequentes

P: Por que recebo o erro Cannot use KILL to kill your own process. ao executar o comando EXEC sp_rds_drop_database 'dbtest'; com uma conta padrão?

R: Execute o comando usando uma conta privilegiada a partir de uma janela de comando conectada a um banco de dados diferente. Certifique-se de que a conta tenha as permissões necessárias no banco de dados de destino. Para obter mais informações, consulte Modificar permissões da conta.