arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

Read Scale-Out

hashtag
Overview

This section provides instructions on how to configure the optional Read Scale-Out feature, which allows load balancing of SQL Database read-only workloads using a read-only replica rather than a read-write replica. For more information on this feature, see the Use read-only replicas to offload read-only query workloadsarrow-up-right Microsoft article.

hashtag
Prerequisites

  • Make sure to have either a Premium or a Business Critical service tier.

  • You must have permissions to make changes to the database in the Azure portal.

hashtag
Read Scale-Out configuration

hashtag
Step 1: Enable the Read Scale-Out feature in PowerShell

  1. Install or update the Azure PowerShell module in PowerShell by running the following commands:

    For more information, see the Microsoft article.

  2. Log in to your Microsoft Azure account in PowerShell by running the following command:

    If you encounter any security issues with the Microsoft Azure sign-in process, then you must manually add https://login.microsoftonline.com/ and all related websites' URIs to the Trusted sites zone in Internet Explorer's Internet Options.

You can also enable Read Scale-Out feature using the .

hashtag
Step 2: Configure WorkflowGen

  1. Go to the Database section on the Configuration Panel General tab. In the Master database connection string field, add the ApplicationIntent=ReadWrite parameter to the existing connection string and click Test to test the database availability. Here's an example of a connection string:

  2. In the Read-only database connection string field, add (or edit) the connection string with the new ApplicationIntent=ReadOnly parameter, and click Test

Enable the Read Scale-Out feature in PowerShell by running the following command:

  • Replace <resource group> with the resource group name.

  • Replace <server name> with the server name (e.g. workflowgen.database.windows.net).

  • Replace <database name> with the database name (e.g. WFGEN).

to test the database availability. Here's an example of a connection string:
  • Check the Multi-database option. Check the User Portal components and modules that will use the Read-only database. For more information about this, see Replica databasearrow-up-right in the WorkflowGen Administration Guidearrow-up-right.

  • Install Azure PowerShellarrow-up-right
    Azure SQL Database Rest APIarrow-up-right
    Set-AzureRmSqlDatabase -ResourceGroupName <resource group> -ServerName <server name> -DatabaseName <database name> -ReadScale Enabled
    Install-Module -Name AzureRM -AllowClobber
    Import-Module -Name AzureRM
    Login-AzureRmAccount
    Data Source=workflowgen.database.windows.net;Initial Catalog=WFGEN;User ID=wfgen_user;Password=Admin123!;encrypt=true;trustServerCertificate=false;ApplicationIntent=ReadWrite;
    Data Source=workflowgen.database.windows.net;Initial Catalog=WFGEN;User ID=wfgen_user;Password=Admin123!;encrypt=true;trustServerCertificate=false;ApplicationIntent=ReadOnly;