DB Mail e alertas de email com o SQL Agent no Linux

Aplica-se a: SQL Server – Linux

As etapas a seguir mostram como configurar o DB Mail e usá-lo com o SQL Server Agent (mssql-server-agent) no Linux.

Habilite o Database Mail.

USE master;
GO

sp_configure 'show advanced options', 1;
GO

RECONFIGURE WITH OVERRIDE
GO

sp_configure 'Database Mail XPs', 1;
GO

RECONFIGURE;
GO

2. Criar uma nova conta

EXECUTE msdb.dbo.sysmail_add_account_sp @account_name = 'SQLAlerts',
    @description = 'Account for Automated DBA Notifications',
    @email_address = 'sqlagenttest@example.com',
    @replyto_address = 'sqlagenttest@example.com',
    @display_name = 'SQL Agent',
    @mailserver_name = 'smtp.example.com',
    @port = 587,
    @enable_ssl = 1,
    @username = 'sqlagenttest@example.com',
    @password = '<password>';
GO

3. Criar um perfil padrão

EXECUTE msdb.dbo.sysmail_add_profile_sp
    @profile_name = 'default',
    @description = 'Profile for sending Automated DBA Notifications';
GO

4. Adiciona a conta do Database Mail a um perfil do Database Mail

EXECUTE msdb.dbo.sysmail_add_principalprofile_sp
    @profile_name = 'default',
    @principal_name = 'public',
    @is_default = 1;
GO

5. Adicionar conta ao perfil

EXECUTE msdb.dbo.sysmail_add_profileaccount_sp
    @profile_name = 'default',
    @account_name = 'SQLAlerts',
    @sequence_number = 1;
GO

6. Enviar email de teste

Talvez seja necessário acessar seu cliente de email e habilitar "permitir que clientes menos seguros enviem email". Nem todos os clientes reconhecem o DB Mail como um daemon de email.

EXECUTE msdb.dbo.sp_send_dbmail
    @profile_name = 'default',
    @recipients = 'recipient-email@example.com',
    @subject = 'Testing DBMail',
    @body = 'This message is a test for DBMail'
GO

7. Definir perfil do DB Mail usando mssql-conf ou variável de ambiente

Você pode usar o utilitário mssql-conf ou variáveis de ambiente para registrar seu perfil do DB Mail. Nesse caso, vamos chamar nosso perfil como padrão.

  • Definir via mssql-conf:

    sudo /opt/mssql/bin/mssql-conf set sqlagent.databasemailprofile default
    
  • Defina variáveis de ambiente:

    MSSQL_AGENT_EMAIL_PROFILE=default
    

8. Configurar um operador para notificações de trabalho do SQLAgent

EXEC msdb.dbo.sp_add_operator
    @name = N'JobAdmins',
    @enabled = 1,
    @email_address = N'recipient-email@example.com',
    @category_name = N'[Uncategorized]';
GO

9. Enviar email quando o 'Trabalho de Teste do Agente' for executado com sucesso

EXEC msdb.dbo.sp_update_job
    @job_name = 'Agent Test Job',
    @notify_level_email = 1,
    @notify_email_operator_name = N'JobAdmins'
GO