Bootstrapping Directly Using the Default Integration Profile

9 Synchronizing with Relational Database Tables 9-1 9 Synchronizing with Relational Database Tables This chapter explains how to synchronize data from tables in a relational database with Oracle Internet Directory. The synchronization can be either incremental—for example, one database table row at a time—or all the database tables at once. The process of synchronization with a database involves executing a directory integration profile and includes the following steps: 1. Retrieving the data from the database. This involves executing a SQL SELECT statement that retrieves the specified data records from the database. 2. Writing the data into the directory. This involves converting the retrieved data records to LDAP attribute values and performing the LDAP operation on the directory. This chapter contains these topics: ■ Preparing the Additional Configuration Information File Note: Multi-valued attribute synchronization from database to Oracle Internet Directory is not supported. The Oracle Directory Integration Platform application does not support database delete operations. You can, however, create an outside trigger that will directly delete entries in Oracle Internet Directory whenever a row is deleted in the database. Information about how to create such a trigger is outside of the scope of this documentation. Oracle Internet Directory 11g Release 1 11.1.1 does not support exporting data from Oracle Internet Directory to a relational database. Note: Before reading this chapter, be sure to familiarize yourself with the introductory chapters about Oracle Directory Integration Platform—specifically: ■ Chapter 1, Introduction to Oracle Identity Management Integration ■ Chapter 5, Understanding the Oracle Directory Synchronization Service 9-2 Oracle Fusion Middleware Administrators Guide for Oracle Directory Integration Platform ■ Preparing the Mapping File ■ Preparing the Directory Integration Profile ■ Example: Synchronizing a Relational Database Table to Oracle Internet Directory

9.1 Preparing the Additional Configuration Information File

During synchronization from a relational database to Oracle Internet Directory, the additional configuration information file governs the retrieval of data from the database. It provides the Oracle Directory Integration Platform with the following information: ■ The SELECT statement to execute ■ Either the attributes or the database columns to be used in incremental synchronization. Generally, this is either an attribute that contains a timestamp or a change sequence number that the next SQL statement should use to retrieve incremental data. To configure this file, use the sample file DBReader.cfg.master in the ORACLE_ HOMEldapodiconf directory, and edit it to your specifications. Formatting the Additional Configuration Information File It is very important to follow the correct format of this file. The various sections are divided using TAG names. Every TAG section has a list of parameters and their respective values. The general layout is as follows: [TAG] PARAMETER1: value PARAMETER2: value [TAG] PARAMETER1: value PARAMETER2: value\ VALUE continuation\ value continuation\ end of value continuation [TAG] PARAMETER1: value PARAMETER2: value\ end of value continuation For example, following this format, the DBReader.cfg.master file looks like this: [DBQUERY] SELECT: SELECT\ EMPNO EmpNum,\ ENAME,\ REPLACEEMAIL,ACME.COM, UID,\ EMAIL,\ TELEPHONE,\ TO_CHARLAST_UPDATE_DATE,YYYYMMDDHH24MISS Modified_Date\ FROM\ EMPLOYEE\ WHERE\ LAST_UPDATE_DATETO_DATE :Modified_Date,YYYYMMDDHH24MISS\ ORDER BY\ LAST_UPDATE_DATE