Referência de wrappers

No SQL Compartilhado, você tem liberdade total dentro dos seus databases: Criar tabelas, procedures, views, índices e dados, do jeito de sempre.

Algumas tarefas, porém, mexem em partes do SQL Server que são da plataforma, como o SQL Agent, o e-mail, a conexão com outros servidores, a senha e a manutenção do banco. Para essas, a plataforma oferece
 procedimentos prontos. Você chama o procedimento, e ele faz a tarefa com segurança e deixa registrado o que foi feito.

Regras:
 - Chame sempre com o nome completo, incluindo o banco: msdb.dbo... ou master.dbo....
 - Use parâmetros com nome: @Parametro = valor.
 - Nas exclusões, o nome é pedido duas vezes, para evitar apagar por engano.
 - Cada login só enxerga e altera o que é do próprio tenant.
 - Os procedimentos de SQL Agent do msdb (operator, alert, categoria e dono de job) devem ser chamados pela janela de consulta do SSMS, e não de dentro de um step de job.

1. SQL Agent — Jobs

Você cria e edita jobs pelo caminho normal do SQL Server (msdb.dbo.sp_add_job, sp_add_jobstep, sp_add_jobschedule), como mostra a receita 4.0. A plataforma entra só onde o SQL Server exigiria administrador:

EXEC msdb.dbo.usp_TenantSqlAgentJob_SetOwner
     @JobName = N'MEU_JOB', @NewOwnerLogin = N'outro_login';

Nota: Na agenda semanal (@freq_type = 8), informe @freq_recurrence_factor = 1. Sem ele, o SQL Server recusa com Msg 14278.

2. SQL Agent — Categorias

A classe (@CategoryClass) pode ser JOB (padrão), ALERT ou OPERATOR.

EXEC msdb.dbo.usp_TenantSqlAgentCategory_Create
     @CategoryName = N'Rotinas Noturnas', @CategoryClass = N'JOB';

3. SQL Agent — Operators (quem recebe os avisos)

EXEC msdb.dbo.usp_TenantSqlAgentOperator_Create
      @OperatorName = N'Equipe TI', @EmailAddress = N'ti@suaempresa.com.br';
      
-- Avisar quando o job falhar (2 = em caso de falha)
 EXEC msdb.dbo.usp_TenantSqlAgentOperator_SetJobNotification
      @JobName = N'MEU_JOB', @OperatorName = N'Equipe TI', @NotifyLevelEmail = 2;

4. SQL Agent — Alerts

EXEC msdb.dbo.usp_TenantSqlAgentAlert_Create
    @AlertName = N'Erro 50001 no ERP', @MessageId = 50001, @DatabaseName = N'MEU_DATABASE';

EXEC msdb.dbo.usp_TenantSqlAgentAlert_SetNotification
    @AlertName = N'Erro 50001 no ERP', @OperatorName = N'Equipe TI';

5. Database Mail — Envio de e-mail

Configurar:

Enviar e acompanhar:

EXEC msdb.dbo.usp_TenantDatabaseMail_Send
    @ProfileName = N'MeuPerfil',
    @recipients  = 'financeiro@suaempresa.com.br',
    @subject     = N'Relatório diário',
    @body        = N'O processamento terminou.';
    
--Se a plataforma configurou o e-mail para você: use msdb.dbo.usp_SkyNova_SendTenantMail, que envia sem precisar informar perfil. O msdb.dbo.usp_SkyNova_GetTenantMailStatus consulta a situação de um envio pelo número dele (@mailitem_id).

6. Linked Server — Consultar outro servidor SQL

EXEC master.dbo.usp_TenantLinkedServer_Create
    @ServerName     = N'SRV_ERP',
    @DataSource     = N'servidor.suaempresa.com.br,1433',
    @RemoteUser     = N'usuario_no_destino',
    @RemotePassword = N'<senha_no_destino>';
SELECT * FROM SRV_ERP.MeuBanco.dbo.MinhaTabela;

--O nome do Linked Server aceita letras, números, _, . e -.

7. Endpoint remoto — Consulta a outro servidor sem Linked Server

EXEC master.dbo.usp_TenantRemoteQuery_Execute
    @EndpointName = N'ERP_ANTIGO',
    @Query        = N'SELECT TOP 10 * FROM dbo.Clientes';

8. Senha — Trocar a sua própria senha

EXEC master.dbo.usp_TenantLogin_TrocarMinhaSenha
    @SenhaAtual = N'<senha_atual>', @NovaSenha = N'<nova_senha>';
    
--A senha de outro login é trocada pela equipe da plataforma. Basta pedir.

9. Manutenção do database

Um procedimento só, master.dbo.usp_TenantDatabase_Maintenance, com a ação no parâmetro @Action:

EXEC master.dbo.usp_TenantDatabase_Maintenance
    @DatabaseName = N'MEU_DATABASE', @Action = 'CHECKDB', @PhysicalOnly = 1;

Para conhecimento:
- Com @TabLock = 1, feche as outras sessões do banco antes, ou o SQL Server recusa com Msg 5030.
- ALTER INDEX e UPDATE STATISTICS de uma tabela você roda direto, sem o procedimento.
- Se você usa a DatabaseIntegrityCheck da Ola Hallengren, importe o script pela plataforma: ela é convertida para usar este procedimento, e o seu job continua igual.

10. O que fica com a equipe da SkyNova

Nesses casos, abra um chamado:
 - Criar, remover ou renomear login e database;
 - Dar ou tirar acesso de um login a um database;
 - Mudar tamanho máximo, crescimento ou arquivos do banco;
 - Backup e restore;
 - Configurações do servidor.

11. Mensagens de erro mais comuns