Skip to content

Commit c89cc6f

Browse files
20220419 1423 refresh database mail
1 parent 4bd4449 commit c89cc6f

4 files changed

Lines changed: 17 additions & 18 deletions

File tree

docs/relational-databases/database-mail/configure-database-mail.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -42,16 +42,16 @@ ms.author: wiassaf
4242
---
4343
# Configure Database Mail
4444
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
45-
This topic describes how to enable and configure [Database Mail](database-mail.md) using the Database Mail Configuration Wizard, and create a Database Mail Configuration script using templates.
45+
This article describes how to enable and configure [Database Mail](database-mail.md) using the Database Mail Configuration Wizard, and create a Database Mail Configuration script using templates.
4646

4747
## <a name="BeforeYouBegin"></a> Before You Begin
48-
Use the **DatabaseMail XPs** option to enable Database Mail on this server. For more information, see [Database Mail XPs Server Configuration Option](../../database-engine/configure-windows/database-mail-xps-server-configuration-option.md) reference topic.
48+
Use the **DatabaseMail XPs** option to enable Database Mail on this server. For more information, see [Database Mail XPs Server Configuration Option](../../database-engine/configure-windows/database-mail-xps-server-configuration-option.md) reference article.
4949

5050
### <a name="Restrictions"></a> Limitations and Restrictions
5151
Enabling [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] Service Broker in any database requires a database lock. If Service Broker was deactivated in `msdb`, to enable Database Mail, first stop [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] Agent so Service Broker can obtain the necessary lock.
5252

5353
### <a name="Security"></a> Security
54-
To configure Database Mail you must be a member of the **sysadmin** fixed server role. To send Database Mail you must be a member of the **DatabaseMailUserRole** database role in the `msdb` database.
54+
To configure Database Mail, you must be a member of the **sysadmin** fixed server role. To send an email with Database Mail, you must be a member of the **DatabaseMailUserRole** database role in the `msdb` database.
5555

5656
## <a name="DBWizard"></a> Use the Database Mail Configuration Wizard
5757

@@ -160,7 +160,7 @@ ms.author: wiassaf
160160
Specify the user name and password required by the SMTP server.
161161

162162
**User name**
163-
Type the user name that Database Mail uses to log in to the SMTP server. The user name is required if the SMTP server requires basic authentication.
163+
Type the user name that Database Mail uses to sign in to the SMTP server. The user name is required if the SMTP server requires basic authentication.
164164

165165
**Password**
166166
Type the password that Database Mail uses to log in to the SMTP server. The password is required if the SMTP server requires basic authentication.
@@ -238,7 +238,7 @@ ms.author: wiassaf
238238
Type a description for the profile. The description is optional.
239239

240240
**SMTP accounts**
241-
Choose one or more accounts for the profile. The priority sets the order in which Database Mail uses the accounts. If no accounts are listed, you must click **Add** to continue, and add a new SMTP account.
241+
Choose one or more accounts for the profile. The priority sets the order in which Database Mail uses the accounts. If no accounts are listed, you must select **Add** to continue, and add a new SMTP account.
242242

243243
**Add**
244244
Add an account to the profile.
@@ -257,7 +257,7 @@ ms.author: wiassaf
257257
### <a name="ExistingProfile"></a> Manage Existing Profile page
258258
Use this page to manage an existing Database Mail profile. A Database Mail profile is a collection of Database Mail accounts. Profiles improve reliability in cases where an e-mail server becomes unreachable, by providing alternative Database Mail accounts. At least one Database Mail account is required. For more information about setting the priority of Database Mail accounts in the profile, see [Create a Database Mail Profile](../../relational-databases/database-mail/create-a-database-mail-profile.md).
259259

260-
Use the **Move Up** and **Move Down** buttons to change the order in which Database Mail accounts are used. This order is determined by a value called the sequence number. **Move Up** lowers the sequence number and **Move Down** increases the sequence number. The sequence number determines the order in which Database Mail uses accounts in the profile. For a new e-mail message, Database Mail starts with the account that has the lowest sequence number. Should that account fail, Database Mail uses the account with the next highest sequence number, and so on until either Database Mail sends the message successfully, or the account with the highest sequence number fails. If the account with the highest sequence number fails, the Database Mail pauses attempts to send the mail for the amount of time configured in the Database Mail **AccountRetryDelay** parameter, then starts the process of attempting to send the mail again, starting with the lowest sequence number. Use the Database Mail **AccountRetryAttempts** parameter, to configure the number of times that the external mail process attempts to send the e-mail message using each account in the specified profile. You can configure the **AccountRetryDelay** and **AccountRetryAttempts** parameters on the **Configure System Parameters** page of the Database Mail Configuration Wizard.
260+
Use the **Move Up** and **Move Down** buttons to change the order in which Database Mail accounts are used. This order is determined by a value called the sequence number. **Move Up** lowers the sequence number and **Move Down** increases the sequence number. The sequence number determines the order in which Database Mail uses accounts in the profile. For a new e-mail message, Database Mail starts with the account that has the lowest sequence number. Should that account fail, Database Mail uses the account with the next highest sequence number, and so on, until either Database Mail sends the message successfully, or the account with the highest sequence number fails. If the account with the highest sequence number fails, the Database Mail pauses attempts to send the mail for the amount of time configured in the Database Mail **AccountRetryDelay** parameter, then starts the process of attempting to send the mail again, starting with the lowest sequence number. Use the Database Mail **AccountRetryAttempts** parameter, to configure the number of times that the external mail process attempts to send the e-mail message using each account in the specified profile. You can configure the **AccountRetryDelay** and **AccountRetryAttempts** parameters on the **Configure System Parameters** page of the Database Mail Configuration Wizard.
261261

262262
**Profile name**
263263
Select the name of the profile to manage.
@@ -295,7 +295,7 @@ ms.author: wiassaf
295295

296296

297297
### <a name="AddAccount"></a> Add Account to Profile Page
298-
Use this page to choose the account to add to the profile. Either choose an existing account from the **Account name** box, or click **New Account**.
298+
Use this page to choose the account to add to the profile. Either choose an existing account from the **Account name** box, or select **New Account**.
299299

300300
**Account name**
301301
Select the name of the account to add to the profile.
@@ -390,7 +390,7 @@ ms.author: wiassaf
390390
The maximum size of an attachment, in bytes.
391391

392392
**Prohibited Attachment File Extensions**
393-
A comma-separated list of extensions which cannot be sent as an attachment to an e-mail message. Click the browse button (**...**) to add additional extensions.
393+
A comma-separated list of extensions that cannot be sent as an attachment to an e-mail message. Select the browse button (**...**) to add additional extensions.
394394

395395
**Database Mail Executable Minimum Lifetime (seconds)**
396396
The minimum amount of time, in seconds, that the external mail process remains active. The process remains active as long as there are e-mails in the Database Mail queue. This parameter specifies the time the process remains active if there are no messages to process.
@@ -437,8 +437,7 @@ ms.author: wiassaf
437437
The **mailitem_id** of the test e-mail message.
438438

439439
**Troubleshoot**
440-
Click to open Books Online to the [Troubleshooting Database Mail](/previous-versions/sql/sql-server-2008-r2/ms188663(v=sql.105))topic.
441-
440+
Opens this Docs article.
442441

443442

444443
## <a name="Template"></a> Use SQL Server Management Studio templates to generate T-SQL

docs/relational-databases/database-mail/configure-sql-server-agent-mail-to-use-database-mail.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ ms.custom: seo-dt-2019
1616
# Configure SQL Server Agent mail to use Database Mail
1717
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
1818

19-
This topic describes how to configure [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] Agent to use [Database Mail](database-mail.md) to send notification and alerts in [!INCLUDE[ssnoversion](../../includes/ssnoversion-md.md)] by using [!INCLUDE[ssManStudioFull](../../includes/ssmanstudiofull-md.md)].
19+
This article describes how to configure [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] Agent to use [Database Mail](database-mail.md) to send notification and alerts in [!INCLUDE[ssnoversion](../../includes/ssnoversion-md.md)] by using [!INCLUDE[ssManStudioFull](../../includes/ssmanstudiofull-md.md)].
2020

2121
- For information on how to enable and configure Database Mail, see [Configure Database Mail](../../relational-databases/database-mail/configure-database-mail.md).
2222
- For an example using [!INCLUDE[tsql](../../includes/tsql-md.md)], see [Create a Database Mail Profile](../../relational-databases/database-mail/create-a-database-mail-profile.md).
@@ -45,7 +45,7 @@ The following steps are not necessary in [!INCLUDE[ssazuremi_md](../../includes/
4545

4646
- In Object Explorer, expand a [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] instance.
4747

48-
- Right-click **SQL Server Agent**, and then click **Properties**.
48+
- Right-click **SQL Server Agent**, and then select **Properties**.
4949

5050
- Select **Alert System**.
5151

@@ -71,4 +71,4 @@ The following steps are not necessary in [!INCLUDE[ssazuremi_md](../../includes/
7171
## Next steps
7272

7373
- [Configure Database Mail](configure-database-mail.md)
74-
- [Automate management tasks using SQL Agent jobs in Azure SQL Managed Instance](/azure/azure-sql/managed-instance/job-automation-managed-instance)
74+
- [Automate management tasks using SQL Agent jobs in Azure SQL Managed Instance](/azure/azure-sql/managed-instance/job-automation-managed-instance)

docs/relational-databases/database-mail/database-mail.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ms.author: wiassaf
1717
---
1818
# Database Mail
1919
[!INCLUDE [SQL Server SQL MI](../../includes/applies-to-version/sql-asdbmi.md)]
20-
Database Mail is an enterprise solution for sending e-mail messages from the [!INCLUDE[ssDEnoversion](../../includes/ssdenoversion-md.md)] or [Azure SQL Managed Instance](/azure/sql-database/sql-database-managed-instance-index). Using Database Mail, your database applications can send e-mail messages to users. The messages can contain query results, and can also include files from any resource on your network.
20+
Database Mail is an enterprise solution for sending e-mail messages from the [!INCLUDE[ssDEnoversion](../../includes/ssdenoversion-md.md)] or [Azure SQL Managed Instance](/azure/sql-database/sql-database-managed-instance-index). Your applications can send e-mail messages to users using Database Mail via an external SMTP server. The messages can contain query results, and can also include files from any resource on your network.
2121

2222
> [!NOTE]
2323
> Database Mail is available in [!INCLUDE[ssDEnoversion](../../includes/ssdenoversion-md.md)] and [Azure SQL Managed Instance](/azure/sql-database/sql-database-managed-instance-index), but not in Azure SQL database singleton and elastic pools. For more information on using Database Mail in [!INCLUDE[ssazuremi_md](../../includes/ssazuremi_md.md)], see [Automate management tasks using SQL Agent jobs in Azure SQL Managed Instance](/azure/azure-sql/managed-instance/job-automation-managed-instance).

docs/relational-databases/system-stored-procedures/sysmail-add-profile-sp-transact-sql.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -51,9 +51,9 @@ sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
5151
**0** (success) or **1** (failure)
5252

5353
## Remarks
54-
A Database Mail profile holds any number of Database Mail accounts. Database Mail stored procedures can refer to a profile by either the profile name or the profile id generated by this procedure. For more information about adding an account to a profile, see [sysmail_add_profileaccount_sp &#40;Transact-SQL&#41;](../../relational-databases/system-stored-procedures/sysmail-add-profileaccount-sp-transact-sql.md).
54+
A Database Mail profile holds any number of Database Mail accounts. Database Mail stored procedures can refer to a profile by either the profile name or the profile ID generated by this procedure. For more information about adding an account to a profile, see [sysmail_add_profileaccount_sp &#40;Transact-SQL&#41;](../../relational-databases/system-stored-procedures/sysmail-add-profileaccount-sp-transact-sql.md).
5555

56-
The profile name and description can be changed with the stored procedure `sysmail_update_profile_sp`, while the profile id remains constant for the life of the profile.
56+
The profile name and description can be changed with the stored procedure `sysmail_update_profile_sp`, while the profile ID remains constant for the life of the profile.
5757

5858
The profile name must be unique in the [!INCLUDE[ssDEnoversion](../../includes/ssdenoversion-md.md)] instance or the stored procedure returns an error.
5959

@@ -74,9 +74,9 @@ EXECUTE msdb.dbo.sysmail_add_profile_sp
7474
@description = 'Profile used for administrative mail.' ;
7575
```
7676

77-
### B. Creating a new profile, saving the profile id in a variable
77+
### B. Creating a new profile, saving the profile ID in a variable
7878

79-
The following example creates a new Database Mail profile named `AdventureWorks Administrator`. The example stores the profile id number in the variable `@profileId` and returns a result set containing the profile id number for the new profile.
79+
The following example creates a new Database Mail profile named `AdventureWorks Administrator`. The example stores the profile ID number in the variable `@profileId` and returns a result set containing the profile ID number for the new profile.
8080

8181
```sql
8282
DECLARE @profileId INT ;

0 commit comments

Comments
 (0)