Algemene technische naslaginformatie over SQL Connector

In dit artikel wordt de algemene SQL-connector beschreven. Het artikel is van toepassing op de volgende producten:

• Microsoft Identity Manager 2016 (MIM2016)
• Microsoft Entra ID

Voor MIM2016 is de connector beschikbaar als download in het Microsoft Downloadcentrum.

Als u deze connector in actie wilt zien, raadpleegt u het stapsgewijze artikel Algemene SQL-connector .

Notitie

Microsoft Entra ID biedt nu een lichtgewicht oplossing op basis van een agent voor het inrichten van gebruikers in een SQL-database, zonder dat er een MIM-synchronisatie-implementatie nodig is. U wordt aangeraden deze te gebruiken voor het inrichten van uitgaande gebruikers. Meer informatie.

Overzicht van de algemene SQL-connector

Met de algemene SQL-connector kunt u de synchronisatieservice integreren met een databasesysteem dat ODBC-connectiviteit biedt.

Vanuit een algemeen perspectief worden de volgende functies ondersteund door de huidige release van de connector:

Functie	Ondersteuning
Verbonden gegevensbron	De connector wordt ondersteund met alle 64-bits ODBC-stuurprogramma's*. Het is getest met het volgende: Microsoft SQL Server & SQL Azure IBM DB2 11.5.8 Oracle 11g Oracle 12c en 18c Oracle 21c en 23c MySQL 5.x MySQL 8.x Postgres
Scenario's	Levenscyclusbeheer van objecten Wachtwoordbeheer
Operations	Volledige import en delta importeren, exporteren Voor Exporteren: Toevoegen, Verwijderen, Bijwerken en Vervangen Wachtwoord instellen, Wachtwoord wijzigen
Schema	Dynamische detectie van objecten en kenmerken

Vereisten

Voordat u de connector gebruikt, moet u ervoor zorgen dat de volgende items op de synchronisatieserver staan:

• Microsoft .NET 4.6.2 Framework of hoger
• 64-bits ODBC-clientstuurprogramma's
• Als u de connector gebruikt om te communiceren met Oracle 12c, is Hiervoor Oracle Instant Client 12.2.0.1 of hoger vereist met het ODBC-pakket.
• Als u de connector gebruikt om te communiceren met Oracle 18c-23c, moet Oracle Instant Client 18-23 of hoger met het ODBC-pakket worden gebruikt en moet de NLS_LANG systeemvariabele worden ingesteld om UTF8-tekens te ondersteunen, bijvoorbeeld NLS_LANG=AMERICAN_AMERICA. AL32UTF8.
• Deze connector maakt gebruik van door SQL voorbereide instructies en meerdere instructies per transactie. Sommige RDBM-systemen hebben mogelijk problemen met hun ODBC-stuurprogramma's met betrekking tot transactieafhandeling, voorbereide SQL-instructies aan de serverzijde en meerdere instructies binnen dezelfde transactie. Configureer uw DSN-verbindingsopties dienovereenkomstig om ervoor te zorgen dat deze instructies correct naar uw database worden verzonden. Voor MySQL ODBC-stuurprogrammaversie 8.0.32 zijn bijvoorbeeld opties NO_SSPS=1 en MULTI_STATEMENTS=1 vereist. Andere opties zoals 'autocommit' of 'commit on successful operations only' kunnen van invloed zijn op de manier waarop batchexports worden verwerkt; Neem contact op met de databasebeheerder voor meer informatie. Als u problemen tijdens het exporteren wilt oplossen, stelt u de grootte van de exportbatch in op 1 en schakelt u uitgebreide logboekregistratie van connectoren in.

Voor het implementeren van deze connector zijn mogelijk wijzigingen in de configuratie van de database en configuratiewijzigingen in MIM vereist. Voor implementaties waarbij MIM wordt geïntegreerd met een databaseserver van derden in een productieomgeving, raden we klanten aan om samen te werken met hun databaseleverancier of een implementatiepartner voor hulp, begeleiding en ondersteuning voor deze integratie.

Machtigingen in verbonden gegevensbron

Als u een van de ondersteunde taken in de algemene SQL-connector wilt maken of uitvoeren, hebt u het volgende nodig:

• db_datareader
• db_datawriter

Poorten en protocollen

Raadpleeg de documentatie van de databaseleverancier voor de vereiste poorten voor de werking van het ODBC-stuurprogramma.

Een nieuwe connector maken

Als u een algemene SQL-connector wilt maken, selecteert u in Synchronisatieservicede optie Beheeragent en Maken. Selecteer de Generic SQL (Microsoft) Connector.

Connectiviteit

De connector gebruikt een ODBC DSN-bestand voor connectiviteit. Maak het DSN-bestand met behulp van ODBC-gegevensbronnen in het menu Start onder Systeembeheer. Maak in het beheerprogramma een bestands-DSN , zodat deze kan worden verstrekt aan de connector.

Het scherm Connectiviteit is het eerste wanneer u een nieuwe algemene SQL-connector maakt. U moet eerst de volgende informatie opgeven:

• DSN-bestandspad
• Verificatie
  • Gebruikersnaam
  • Wachtwoord

De database moet een van deze verificatiemethoden ondersteunen:

• Windows-verificatie: de verificatiedatabase gebruikt de Windows-referenties om de gebruiker te verifiëren. De opgegeven gebruikersnaam/het opgegeven wachtwoord wordt gebruikt voor verificatie met de database. Dit account heeft machtigingen voor de database nodig.
• SQL-verificatie: de verificatiedatabase gebruikt de gebruikersnaam/het wachtwoord die is gedefinieerd op het scherm Connectiviteit om verbinding te maken met de database. Als u de gebruikersnaam/het wachtwoord in het DSN-bestand opslaat, hebben de referenties op het scherm Connectiviteit voorrang.
• Azure SQL databaseverificatie: zie Verbinding maken met SQL Database via Microsoft Entra-verificatie voor meer informatie.

DN is anker: als u deze optie selecteert, wordt de DN ook gebruikt als het ankerkenmerk. Het kan worden gebruikt voor een eenvoudige implementatie, maar heeft ook de volgende beperking:

• Connector ondersteunt slechts één objecttype. Daarom kunnen verwijzingskenmerken alleen verwijzen naar hetzelfde objecttype.

Exporttype: Object vervangen: wanneer tijdens het exporteren slechts enkele kenmerken zijn gewijzigd, wordt het hele object met alle kenmerken geëxporteerd en vervangt het het bestaande object.

Schema 1 (Objecttypen detecteren)

Op deze pagina configureert u hoe de connector de verschillende objecttypen in de database zoekt.

Elk objecttype wordt weergegeven als een partitie en verder geconfigureerd in Partities en hiërarchieën configureren.

Detectiemethode objecttype: de connector ondersteunt deze detectiemethoden voor objecttypen.

• Vaste waarde: u geeft de lijst met objecttypen op met een door komma's gescheiden lijst. Bijvoorbeeld: User,Group,Department.
  
• Tabel/weergave/opgeslagen procedure: geef de naam op van de tabel-/weergave-/opgeslagen procedure en vervolgens de kolomnaam die de lijst met objecttypen bevat. Als u een opgeslagen procedure gebruikt, geeft u er ook parameters voor op in de indeling [Naam]:[Richting]:[Waarde]. Geef elke parameter op een afzonderlijke regel op (gebruik Ctrl+Enter om een nieuwe regel op te halen).
  
• SQL-query: met deze optie kunt u een SQL-query opgeven die één kolom met objecttypen retourneert, bijvoorbeeld SELECT [Column Name] FROM TABLENAME. De geretourneerde kolom moet van het type tekenreeks (varchar) zijn.

Schema 2 (kenmerktypen detecteren)

Op deze pagina configureert u hoe de kenmerknamen en -typen worden gedetecteerd. De configuratieopties worden weergegeven voor elk objecttype dat op de vorige pagina is gedetecteerd.

Detectiemethode voor kenmerktypen: de connector ondersteunt deze detectiemethoden voor kenmerktypen met elk gedetecteerd objecttype in het scherm Schema 1.

• Tabel/weergave/opgeslagen procedure: geef de naam op van de tabel/weergave/opgeslagen procedure die moet worden gebruikt om de kenmerknamen te vinden. Als u een opgeslagen procedure gebruikt, geeft u er ook parameters voor op in de indeling [Naam]:[Richting]:[Waarde]. Geef elke parameter op een afzonderlijke regel op (gebruik Ctrl+Enter om een nieuwe regel op te halen). Als u de kenmerknamen in een kenmerk met meerdere waarden wilt detecteren, geeft u een door komma's gescheiden lijst met tabellen of weergaven op. Scenario's met meerdere waarden worden niet ondersteund wanneer bovenliggende en onderliggende tabellen dezelfde kolomnamen hebben.
• SQL-query: met deze optie kunt u een SQL-query opgeven die één kolom retourneert met kenmerknamen, bijvoorbeeld SELECT [Column Name] FROM TABLENAME. De geretourneerde kolom moet van het type tekenreeks (varchar) zijn.

Schema 3 (Anker en DN definiëren)

Op deze pagina kunt u anker en DN-kenmerk configureren voor elk gedetecteerd objecttype. U kunt meerdere kenmerken selecteren om het anker uniek te maken.

• Kenmerken met meerdere waarden en Booleaanse waarden worden niet vermeld.

• Hetzelfde kenmerk kan niet worden gebruikt voor DN en anker, tenzij DN is Anker is geselecteerd op de pagina Connectiviteit.

• Als DN is Anker is geselecteerd op de pagina Connectiviteit, is voor deze pagina alleen het kenmerk DN vereist. Dit kenmerk wordt ook gebruikt als het ankerkenmerk.

  

Schema 4 (Kenmerktype, verwijzing en richting definiëren)

Op deze pagina kunt u het kenmerktype, zoals geheel getal, binair of Booleaanse waarde, en de richting voor elk kenmerk configureren. Alle kenmerken van paginaschema 2 worden weergegeven, inclusief kenmerken met meerdere waarden.

• DataType: wordt gebruikt om het kenmerktype toe te wijzen aan de typen die bekend zijn bij de synchronisatie-engine. Standaard wordt hetzelfde type gebruikt als in het SQL-schema, maar datum/tijd en verwijzing zijn niet eenvoudig te detecteren. Hiervoor moet u Datum/tijd of Verwijzing opgeven.
• Richting: u kunt de kenmerkrichting instellen op Import, Export of ImportExport. ImportExport is standaard.

Opmerkingen:

• Als een kenmerktype niet kan worden gedetecteerd door de connector, wordt het gegevenstype Tekenreeks gebruikt.
• Geneste tabellen kunnen worden beschouwd als databasetabellen met één kolom. Oracle slaat de rijen van een geneste tabel op in een bepaalde volgorde. Wanneer u de geneste tabel echter ophaalt in een PL/SQL-variabele, krijgen de rijen opeenvolgende subscripts, beginnend bij 1. Dit geeft u matrixachtige toegang tot afzonderlijke rijen.
• VARRYS wordt niet ondersteund in de connector.

Schema 5 (Partitie definiëren voor referentiekenmerken)

Op deze pagina configureert u voor alle referentiekenmerken naar welke partitie (objecttype) een kenmerk verwijst.

Als u DN is anker gebruikt, moet u hetzelfde objecttype gebruiken als het object waarnaar u verwijst. U kunt niet verwijzen naar een ander objecttype.

Notitie

Vanaf de update van maart 2017 is er nu een optie voor '*' Wanneer deze optie wordt gekozen, worden alle mogelijke lidtypen geïmporteerd.

Belangrijk

Vanaf mei 2017 is de "*" oftewel elke optie gewijzigd om import- en exportstroom te ondersteunen. Als u deze optie wilt gebruiken, moet uw tabel/weergave met meerdere waarden een kenmerk hebben dat het objecttype bevat.

Als *is geselecteerd, moet ook de naam van de kolom met het objecttype worden opgegeven.

Na het importeren ziet u iets dat lijkt op de onderstaande afbeelding:

Globale parameters

De pagina Algemene parameters wordt gebruikt voor het configureren van Delta-import, datum-/tijdnotatie en wachtwoordmethode.

De algemene SQL-connector ondersteunt de volgende methoden voor Delta Import:

• Trigger: zie Deltaweergaven genereren met triggers.
• Watermerk: een algemene benadering die kan worden gebruikt met elke database. De watermerkquery wordt vooraf ingevuld op basis van de databaseleverancier. Een watermerkkolom moet aanwezig zijn in elke tabel/weergave die wordt gebruikt. In deze kolom moeten invoegingen en updates van de tabellen worden bijgehouden als en de afhankelijke tabellen (met meerdere waarden of onderliggende tabellen). De klokken tussen de synchronisatieservice en de databaseserver moeten worden gesynchroniseerd. Als dat niet het doel is, worden sommige vermeldingen in de delta-import mogelijk weggelaten.
  Beperking:
  • Watermerkstrategie biedt geen ondersteuning voor verwijderde objecten.
• Momentopname: (Werkt alleen met Microsoft SQL Server) Delta-weergaven genereren met behulp van momentopnamen
• Wijzigingen bijhouden: (Werkt alleen met Microsoft SQL Server) Over Wijzigingen bijhouden
  Beperkingen:
  • Anker & DN-kenmerk moet deel uitmaken van de primaire sleutel voor het geselecteerde object in de tabel.
  • SQL-query wordt niet ondersteund tijdens importeren en exporteren met Wijzigingen bijhouden.

Aanvullende parameters: geef de tijdzone van de databaseserver op die aangeeft waar uw databaseserver zich bevindt. Deze waarde wordt gebruikt ter ondersteuning van de verschillende notaties van datum- & tijdkenmerken.

De connector slaat datum en tijd altijd op in UTC-indeling. Als u de datum en tijden correct wilt converteren, moeten de tijdzone van de databaseserver en de gebruikte indeling worden opgegeven. De indeling moet worden uitgedrukt in .NET-indeling.

Tijdens het exporteren moet elk datum/tijd-kenmerk worden opgegeven aan de connector in UTC-tijdnotatie.

Wachtwoordconfiguratie: de connector biedt mogelijkheden voor wachtwoordsynchronisatie en ondersteunt het instellen en wijzigen van wachtwoorden.

De connector biedt twee methoden ter ondersteuning van wachtwoordsynchronisatie:

• Opgeslagen procedure: voor deze methode zijn twee opgeslagen procedures vereist ter ondersteuning van Instellen & wachtwoord wijzigen. Typ alle parameters voor het toevoegen en wijzigen van de wachtwoordbewerking in respectievelijk Wachtwoord SP instellen en Wachtwoord SP-parameters wijzigen , zoals in het onderstaande voorbeeld.
• Wachtwoordextensie: voor deze methode is het DLL-bestand voor de wachtwoordextensie vereist (u moet de extensie-DLL-naam opgeven die de IMAExtensible2Password-interface implementeert). De assembly van de wachtwoordextensie moet in de extensiemap worden geplaatst, zodat de connector het DLL-bestand tijdens runtime kan laden.

U moet ook wachtwoordbeheer inschakelen op de pagina Extensie configureren .

Partities en hiërarchieën configureren

Selecteer alle objecttypen op de pagina partities en hiërarchieën. Elk objecttype heeft een eigen partitie.

U kunt ook de waarden overschrijven die zijn gedefinieerd op de pagina Connectiviteit of Globale parameters .

Ankers configureren

Deze pagina is alleen-lezen omdat het anker al is gedefinieerd. Het geselecteerde ankerkenmerk wordt altijd toegevoegd aan het objecttype om ervoor te zorgen dat het uniek blijft voor alle objecttypen.

Stapparameter uitvoeren configureren

Deze stappen worden geconfigureerd voor de uitvoeringsprofielen op de connector. Deze configuraties doen het werkelijke werk van het importeren en exporteren van gegevens.

Volledig en Delta-import

Algemene SQL Connector biedt ondersteuning voor Volledige en Delta-import met behulp van de volgende methoden:

• Tabel
• Weergave
• Opgeslagen procedure
• SQL Query

Tabel/weergave
Als u kenmerken met meerdere waarden voor een object wilt importeren, moet u de naam van de tabel/weergave opgeven in Naam van tabel/weergaven met meerdere waarden en de respectieve joinvoorwaarden in de voorwaarde Join met de bovenliggende tabel. Als de gegevensbron meer dan één tabel met meerdere waarden bevat, kunt u samenvoeging gebruiken voor één weergave.

Belangrijk

De algemene SQL-beheeragent kan slechts met één tabel met meerdere waarden werken. Voer in Naam van tabel met meerdere waarden/weergaven niet meer dan één naam van de tabel in. Dit is de beperking van algemene SQL.

Voorbeeld: u wilt het employee-object en alle bijbehorende kenmerken met meerdere waarden importeren. Er zijn twee tabellen, met de naam Werknemer (hoofdtabel) en Afdeling (meerdere waarden). Ga als volgt te werk:

• Typ Werknemer in Tabel/Weergave/SP.
• Typ Afdeling bij Naam van tabel/weergaven met meerdere waarden.
• Typ de joinvoorwaarde tussen Employee & Department in Join Condition, bijvoorbeeld Employee.DEPTID=Department.DepartmentID.

Opgeslagen procedures

• Als u veel gegevens hebt, is het raadzaam om paginering te implementeren met uw opgeslagen procedures.
• Als u wilt dat uw opgeslagen procedure paginering ondersteunt, moet u beginindex en eindindex opgeven. Zie Efficiënt paging door grote hoeveelheden gegevens.
• @StartIndex en @EndIndex worden tijdens de uitvoering vervangen door de waarde van het betreffende paginaformaat die is geconfigureerd op de pagina Stap configureren . Wanneer de connector bijvoorbeeld de eerste pagina ophaalt en het paginaformaat is ingesteld op 500, is dit in een dergelijke situatie @StartIndex 1 en @EndIndex 500. Deze waarden worden verhoogd wanneer de connector volgende pagina's ophaalt en de @StartIndex & @EndIndex waarde wijzigt.
• Als u een opgeslagen procedure met parameters wilt uitvoeren, geeft u de parameters op in [Name]:[Direction]:[Value] de indeling. Voer elke parameter op een afzonderlijke regel in (gebruik Ctrl + Enter om een nieuwe regel op te halen).
• De algemene SQL-connector ondersteunt ook importbewerking van gekoppelde servers in Microsoft SQL Server. Als er gegevens moeten worden opgehaald uit een tabel in gekoppelde server, moet tabel worden opgegeven in de indeling: [ServerName].[Database].[Schema].[TableName]
• Algemene SQL Connector ondersteunt alleen objecten met een vergelijkbare structuur (zowel aliasnaam als gegevenstype) tussen informatie over uitvoeringsstappen en schemadetectie. Als het geselecteerde object uit het schema en de verstrekte informatie tijdens de uitvoeringsstap verschilt, kan SQL Connector dit type scenario's niet ondersteunen.

SQL-query

Belangrijk

CRLF of nieuw regelteken fungeert als scheidingsteken tussen meerdere instructies.

Voorbeeld van SQL-query met paginering: onjuiste query, werkt niet als het nieuwe regelteken wordt gebruikt:

WITH A AS 
  (select dense_rank() over (order by BusinessEntityID) 
    rownumber, BusinessEntityID, DeptID, NationalIDNumber, LoginID, JobTitle, BirthDate, MaritalStatus, HireDate, ModifiedDate, Password 
    from Employees
  ) select * from A where rownumber between @StartIndex and @EndIndex

Voorbeeld van SQL-query met paginering - juiste query:

WITH A AS (select dense_rank() over (order by BusinessEntityID) rownumber, BusinessEntityID, DeptID, NationalIDNumber, LoginID, JobTitle, BirthDate, MaritalStatus, HireDate, ModifiedDate, Password from Employees) select * from A where rownumber between @StartIndex and @EndIndex

• Query's voor meerdere resultatensets worden niet ondersteund.
• SQL-query ondersteunt de paginering en biedt startindex en eindindex als een variabele ter ondersteuning van paginering.

Delta-Import

Delta Import-configuratie vereist wat meer configuratie in vergelijking met volledige import.

• Als u de methode Trigger of Momentopname kiest om deltawijzigingen bij te houden, geeft u geschiedenistabel of momentopnamedatabase op in het vak Naam van de geschiedenistabel of momentopnamedatabase .
• U moet ook een joinvoorwaarde opgeven tussen de tabel Geschiedenis en de bovenliggende tabel, bijvoorbeeld Employee.ID=History.EmployeeID
• Als u de transactie in de bovenliggende tabel wilt bijhouden vanuit de geschiedenistabel, moet u de kolomnaam opgeven die de bewerkingsgegevens bevat (Toevoegen/Bijwerken/Verwijderen).
• Als u Watermerk kiest om deltawijzigingen bij te houden, geeft u de kolomnaam op die de bewerkingsgegevens bevat in Kolomnaam watermarkering.
• De kenmerkkolom Change Type is vereist voor het wijzigingstype. In deze kolom wordt een wijziging in de primaire tabel of tabel met meerdere waarden toegewezen aan een wijzigingstype in de deltaweergave. Deze kolom kan het Modify_Attribute wijzigingstype voor wijziging op kenmerkniveau bevatten of een wijzigingstype Toevoegen, Wijzigen of Verwijderen voor een wijzigingstype op objectniveau. Als het iets anders is dan de standaardwaarde Toevoegen, Wijzigen of Verwijderen, kunt u deze waarden definiëren met behulp van deze optie.

Exporteren

Algemene SQL Connector ondersteunt exporteren met behulp van vier ondersteunde methoden, zoals:

• Tabel
• Weergave
• Opgeslagen procedure
• SQL Query

Tabel/weergave
Als u de optie Tabel/weergave kiest, genereert de connector de respectieve query's om de export uit te voeren.

Opgeslagen procedures

Als u de optie Opgeslagen procedure kiest, zijn voor Exporteren drie verschillende opgeslagen procedures vereist om invoeg-/update-/verwijderbewerkingen uit te voeren.

• SP-naam toevoegen: deze SP wordt uitgevoerd als er een object naar de connector komt voor invoeging in de respectieve tabel.
• SP-naam bijwerken: deze SP wordt uitgevoerd als er een object naar de connector komt voor update in de respectieve tabel.
• SP-naam verwijderen: deze SP wordt uitgevoerd als er een object naar de connector komt voor verwijdering in de betreffende tabel.
• Kenmerk geselecteerd uit het schema dat als parameterwaarde wordt gebruikt voor de opgeslagen procedure. (EmployeeName is bijvoorbeeld @EmployeeName: INPUT: EmployeeName geselecteerd in het connectorschema en de connector vervangt de respectieve waarde tijdens het exporteren)
• Als u een opgeslagen procedure met parameters wilt uitvoeren, geeft u parameters op in [Name]:[Direction]:[Value] de indeling. Voer elke parameter op een afzonderlijke regel in (gebruik Ctrl + Enter om een nieuwe regel op te halen).

SQL-query

Als u de optie SQL-query kiest, zijn voor Exporteren drie verschillende query's vereist om invoeg-/update-/verwijderbewerkingen uit te voeren.

• Query invoegen: deze query wordt uitgevoerd als een object naar de connector komt voor invoeging in de betreffende tabel.
• Query bijwerken: deze query wordt uitgevoerd als een object naar de connector komt voor update in de betreffende tabel.
• Query verwijderen: deze query wordt uitgevoerd als er een object naar de connector komt voor verwijdering in de betreffende tabel.
• Kenmerk geselecteerd uit het schema dat als parameterwaarde voor de query wordt gebruikt, bijvoorbeeld Insert into Employee (ID, Name) Values (@ID, @EmployeeName)

Belangrijk

CRLF of nieuw regelteken fungeert als scheidingsteken tussen meerdere instructies.

Voorbeeld van een SQL-query met meerdere stappen bijwerken: het nieuwe regelteken wordt gebruikt om SQL-instructies van elkaar te scheiden:

update Employee set jobTitle=@JOBTITLE where BusinessEntityID=@BUSINESSENTITYID
insert into ChangeLog VALUES (@BUSINESSENTITYID)

Problemen oplossen

• Zie ETW-tracering inschakelen voor connectors voor informatie over het inschakelen van logboekregistratie om problemen met de connector op te lossen.