Active Roles 7.3.1 - Synchronization Service Administrator Guide

Synchronization Service Overview Deploying Synchronization Service Getting started Connections to external data systems
External data systems supported out of the box
Working with Active Directory Working with an AD LDS (ADAM) instance Working with Skype for Business Server Working with Exchange Server Working with Active Roles Working with One Identity Manager Working with a delimited text file Working with Microsoft SQL Server Sample queries to modify SQL Server data Working with an OLE DB-compliant relational database Working with SharePoint Working with Microsoft Office 365 Working with Microsoft Azure Active Directory
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 Appendix A: Developing PowerShell scripts for attribute synchronization rules Appendix B: Using a PowerShell script to transform passwords

How to insert an object into a table

How to insert 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 55: How to insert 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)

How to create a SQL Server account

How to create a 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 box:

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

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

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 attribute names used in SQL queries can include white-space characters. For example, you cannot use names such as "user password".

Working with an OLE DB-compliant relational database

Working with an OLE DB-compliant relational database

This section describes how to create or modify a connection to an OLE DB-compliant relational database so that Synchronization Service could work with data in that database.

To create a connection to an OLE DB-compliant relational database, you need to use Synchronization Service in conjunction with a special connector called OLE DB Connector. This connector is included in the Synchronization Service package.

The OLE DB Connector supports the following features:

 

Table 56: Supported features

Feature

Supported

Bidirectional synchronization

Allows you to read and write data in the connected data system.

No

By using this connector, you can only read data in the connected data system.

Delta processing mode

Allows you to process only the data that has changed in the connected data system since the last synchronization operation, thereby reducing the overall synchronization operation time.

No

Password synchronization

Allows you to synchronize user passwords from an Active Directory domain to the connected data system.

No

In this section:

Creating an OLE DB-compliant relational database connection

Creating an OLE DB-compliant relational database connection

To create a new connection

In the Synchronization Service Administration Console, open the Connections tab.

Click Add connection, and then use the following options:

Connection name. Type a descriptive name for the connection.

Use the specified connector. Select OLE DB Connector.

Click Next.

Use the Connection string text box to type the connection parameters to access the OLE DB-compliant relational database. Alternatively, you can click the Configure button to specify the connection parameters by using a dialog box provided by Windows.

Click Next.

On the Specify how to select data page, use the following options:

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 data for synchronization. For example, you can use this option to specify multiple database tables.

Click Next.

On the Specify attributes to identify objects page, use the following options:

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.

Click Finish to create a connection to the OLE DB-compliant relational database.

Related Documents