Chat now with support
Chat with Support

Active Roles 8.1.3 - Synchronization Service Administration Guide

Synchronization Service overview Deploying Synchronization Service Deploying Synchronization Service for use with AWS Managed Microsoft AD Getting started Connections to external data systems
External data systems supported with built-in connectors
Working with Active Directory Working with an AD LDS (ADAM) instance Working with Skype for Business Server Working with Oracle Database Working with Oracle Database user accounts Working with Exchange Server Working with Active Roles Working with One Identity Manager Working with a delimited text file Working with Microsoft SQL Server Working with Micro Focus NetIQ Directory Working with Salesforce Working with ServiceNow Working with Oracle Unified Directory Working with an LDAP directory service Working with an OpenLDAP directory service Working with IBM DB2 Working with IBM AS/400 Working with IBM RACF Working with MySQL database Working with an OLE DB-compliant relational database Working with SharePoint Working with Microsoft 365 Working with Microsoft Azure Active Directory Configuring data synchronization with the SCIM Connector Configuring data synchronization with the Generic SCIM Connector
Using connectors installed remotely Creating a connection Renaming a connection Deleting a connection Modifying synchronization scope for a connection Using connection handlers Specifying password synchronization settings for a connection
Synchronizing identity data Mapping objects Automated password synchronization Synchronization history Scenarios of use Developing PowerShell scripts for attribute synchronization rules Using PowerShell script to transform passwords

Specifying how to select and modify data for a Microsoft SQL Server connection

The Specify how to select and modify data setting allows you to configure how to select and modify the data you want to be included in the synchronization process:

  • Use data from this table: Allows you to select a database table that includes the data you want to participate in the synchronization operations. You can click Preview to preview the database table you have selected.

  • Use an SQL query to specify data: Allows you to compose an SQL query that provides a more flexible way for specifying the data for synchronization. For example, you can use this option to specify multiple database tables.

  • Configure Settings: Specifies the settings for modifying data in the connected system during synchronization operations. For example, you can specify the database tables in which you want to insert, update, or delete data during synchronization operations.


Allows you to configure the running timeout for all SQL queries you specified in the connection settings (for example, those specified in the Specify How to Select and Modify Data option). Use the SQL query execution timeout box to type the timeout value you want to use.

Specifying attributes to identify objects for a Microsoft SQL Server connection

The Specify attributes to identify objects setting provides the following options that allow you to specify the attributes with which you want to uniquely identify each object in the connected data system:

  • Available attributes: Lists the attributes that are available in the external data system. Use this list to select the attributes whose values you want to use to generate a unique identifier for each object in the external data system. You can filter attributes by typing in the text box at the top of this list. To select multiple attributes, hold down CTRL and click to select attributes in the list.

  • UniqueID attributes: Lists the attributes whose values are currently used to generate a unique identifier for each object in the external data system.

  • Add->: Moves the selected attributes from the Available attributes list to the UniqueID attributes list.

  • <-Remove: Moves the selected attributes from the UniqueID attributes list to the Available attributes list.

  • Constructed UniqueID: Displays a combination of the attributes whose values will make up a unique identifier for each object in the external data system.

Sample queries to modify SQL Server data

This section provides some sample SQL queries illustrating how to modify SQL Server data during synchronization operations. In the sample queries, Id refers to an attribute (a column name in an SQL Server table) that uniquely identifies an object in your SQL database. These examples can be used only for configuring connections to Microsoft SQL Server 2005.

Example: Inserting an object into a table

This sample illustrates how to create a query that inserts an object with specified attributes into the table named SQLConnTest1.

Table 41: Inserting an object into a table

Database table structure

Sample query

CREATE TABLE [SQLConnTest1]([Id] [bigint] IDENTITY(1,1),[attr1] [nchar](64),[attr2] [nchar](64)))

INSERT into SQLConnTest1(Id) values(@Id)

Example: Creating an SQL Server account

This sample illustrates how to create a SQL Server account, and then retrieve the UniqueID attribute for that account.

To define the scope where to create the SQL Server account, insert the following query in the Query Editor dialog:

SELECT sid as Id,name as login from sys.server_principals

Insert the following SQL query into the Configure SQL Statements dialog:

EXEC sp_addlogin @login, @newPassword;

EXEC sp_adduser @login,@login,'db_owner';

SELECT sid as Id from sys.server_principals where name=@login;

IMPORTANT: None of the attribute names used in SQL queries can include whitespace characters. For example, you cannot use names such as "user password".

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating