Documentazione tecnica sul connettore Generic SQLGeneric SQL Connector technical reference

Questo articolo descrive il connettore Generic SQLThis article describes the Generic SQL Connector. ed è applicabile ai prodotti seguenti:The article applies to the following products:

  • Microsoft Identity Manager 2016 (MIM2016)Microsoft Identity Manager 2016 (MIM2016)
  • Forefront Identity Manager 2010 R2 (FIM2010R2)Forefront Identity Manager 2010 R2 (FIM2010R2)
    • È necessario usare l'hotfix 4.1.3671.0 o versione successiva ( KB3092178).Must use hotfix 4.1.3671.0 or later KB3092178.

Per MIM2016 e FIM2010R2 il connettore è disponibile come download dall' Area download Microsoft.For MIM2016 and FIM2010R2, the Connector is available as a download from the Microsoft Download Center.

Per vedere come funziona questo connettore, vedere l'articolo relativo alle istruzioni dettagliate per il connettore SQL generico .To see this Connector in action, see the Generic SQL Connector step-by-step article.

Panoramica del connettore Generic SQLOverview of the Generic SQL Connector

Il connettore Generic SQL consente di integrare il servizio di sincronizzazione con un sistema di database che offre la connettività ODBC.The Generic SQL Connector enables you to integrate the synchronization service with a database system that offers ODBC connectivity.

A livello generale, le funzionalità seguenti sono supportate dalla versione corrente del connettore:From a high-level perspective, the following features are supported by the current release of the connector:

FunzionalitàFeature SupportoSupport
Origine dati connessaConnected data source Il connettore è supportato con tutti i driver ODBC a 64 bit.The Connector is supported with all 64-bit ODBC drivers. È stato testato con quanto segue: It has been tested with the following:
  • Microsoft SQL Server e QL AzureMicrosoft SQL Server & SQL Azure
  • IBM DB2 10.xIBM DB2 10.x
  • IBM DB2 9.xIBM DB2 9.x
  • Oracle 10 e 11gOracle 10 & 11g
  • MySQL 5.xMySQL 5.x
  • ScenariScenarios
  • Gestione del ciclo di vita degli oggettiObject Lifecycle Management
  • Gestione delle passwordPassword Management
  • OperazioniOperations
  • Importazione completa e importazione ed esportazione differenzialeFull Import and Delta Import, Export
  • Per l'esportazione: Aggiungi, Elimina, Aggiorna e SostituisciFor Export: Add, Delete, Update, and Replace
  • Imposta password, Cambia passwordSet Password, Change Password
  • SCHEMASchema
  • Individuazione dinamica di oggetti e attributiDynamic discovery of objects and attributes
  • PrerequisitiPrerequisites

    Prima di usare il connettore, verificare che nel server di sincronizzazione sia disponibile quanto segue:Before you use the Connector, make sure you have the following on the synchronization server:

    • Microsoft .NET 4.5.2 Framework o versione successivaMicrosoft .NET 4.5.2 Framework or later
    • Driver client ODBC a 64 bit64-bit ODBC client drivers

    Autorizzazioni nell'origine dati connessaPermissions in connected data source

    Per creare o eseguire una delle operazioni supportate nel connettore Generic SQL, è necessario avere:To create or perform any of the supported tasks in Generic SQL connector, you must have:

    • db_datareaderdb_datareader
    • db_datawriterdb_datawriter

    Porte e protocolliPorts and protocols

    Per le porte necessarie per il funzionamento del driver ODBC, vedere la documentazione del fornitore del database.For the ports required for the ODBC driver to work, consult the database vendor's documentation.

    Creare un nuovo connettoreCreate a new Connector

    Per creare un connettore Generic SQL, in Synchronization Service selezionare Management Agent e quindi Create.To Create a Generic SQL connector, in Synchronization Service select Management Agent and Create. Selezionare il connettore Generic SQL (Microsoft) .Select the Generic SQL (Microsoft) Connector.

    CreateConnector

    ConnettivitàConnectivity

    Il connettore usa un file DSN ODBC per la connettività.The Connector uses an ODBC DSN file for connectivity. Creare il file DSN tramite Origini dati ODBC disponibile nel menu Start in Strumenti di amministrazione.Create the DSN file using ODBC Data Sources found in the start menu under Administrative Tools. Nello strumento di amministrazione creare un DSN file da passare al connettore.In the administrative tool, create a File DSN so it can be provided to the Connector.

    CreateConnector

    La schermata Connectivity è la prima visualizzata quando si crea un nuovo connettore Generic SQL.The Connectivity screen is the first when you create a new Generic SQL Connector. Prima di tutto è necessario specificare le informazioni seguenti:You first need to provide the following information:

    • Percorso del file DSNDSN file path
    • AuthenticationAuthentication
      • User NameUser Name
      • PasswordPassword

    Il database deve supportare uno di questi metodi di autenticazione:The database should support one of these authentication methods:

    • Autenticazione di Windows: il database di autenticazione usa le credenziali di Windows per verificare l'utente.Windows authentication: The authenticating database uses the Windows credentials to verify the user. Il nome utente e la password specificati vengono usati per l'autenticazione nel database.The user name/password specified is used to authenticate with the database. Questo account deve avere autorizzazioni sul database.This account needs permissions to the database.
    • Autenticazione SQL: il database di autenticazione usa il nome utente e la password definiti nella schermata Connectivity (Connettività) per connettersi al database.SQL authentication: The authenticating database uses the user name/password defined one the Connectivity screen to connect to the database. Se si archiviano il nome utente e la password nel file DSN, le credenziali fornite nella schermata Connectivity (Connettività) hanno la precedenza.If you store the user name/pasword in the DSN file, the credentials provided on the Connectivity screen have precedence.
    • Autenticazione del database SQL di Azure: per altre informazioni, vedere Connettersi al database SQL con l'autenticazione di Azure Active Directory.Azure SQL Database authentication: For more information, see Connect to SQL Database By Using Azure Active Directory Authentication.

    DN is Anchor(DN è Anchor): se si seleziona questa opzione, il DN viene usato anche come attributo di ancoraggio.DN is Anchor: If you select this option, the DN is also used as the anchor attribute. Può essere usato per un'implementazione semplice, ma presenta anche la limitazione seguente:It can be used for a simple implementation but also has the following limitation:

    • Il connettore supporta solo un tipo di oggetto.Connector supports only one object type. Di conseguenza gli attributi di riferimento possono fare riferimento solo allo stesso tipo di oggetto.Therefore any reference attributes can only reference the same object type.

    Export Type: Object Replace(Tipo di esportazione: sostituzione oggetto): durante l'esportazione se solo alcuni attributi sono stati modificati, l'intero oggetto con tutti gli attributi viene esportato e sostituisce l'oggetto esistente.Export Type: Object Replace: During export, when only some attributes have changed, the entire object with all attributes is exported and replaces the existing object.

    Schema 1 (rilevare i tipi di oggetto)Schema 1 (Detect object types)

    In questa pagina si configura il modo in cui il connettore troverà i diversi tipi di oggetto nel database.On this page, you are going to configure how the Connector is going to find the different object types in the database.

    Ogni tipo di oggetto viene presentato come una partizione e configurato ulteriormente in Configurare partizioni e gerarchie.Every object type is presented as a partition and configured further on Configure Partitions and Hierarchies.

    schema1a

    Object Type detection method: il connettore supporta questi metodi di rilevamento del tipo di oggetto.Object Type detection method: The Connector supports these object type detection methods.

    • Fixed Value(Valore fisso): specificare l'elenco dei tipi di oggetto con un elenco con valori delimitati da virgole.Fixed Value: You provide the list of object types with a comma-separated list. Ad esempio: User,Group,Department.For example: User,Group,Department.
      schema1bschema1b
    • Table/View/Stored Procedure(Tabella/Vista/Stored procedure): fornire il nome della tabella/vista/stored procedure, quindi il nome della colonna che fornisce l'elenco dei tipi di oggetto.Table/View/Stored Procedure: Provide the name of the table/view/stored procedure and then the column name that provides the list of object types. Se si usa una stored procedure, fornire anche i relativi parametri nel formato [Nome]:[Direzione]:[Valore].If you use a stored procedure, then also provide parameters for it in the format [Name]:[Direction]:[Value]. Specificare ogni parametro su una riga separata (usare CTRL+INVIO per ottenere una nuova riga).Provide each parameter on a separate line (use Ctrl+Enter to get a new line).
      schema1cschema1c
    • SQL Query (Query SQL): questa opzione consente di fornire una query SQL che restituisce una singola colonna con i tipi di oggetto, ad esempio SELECT [Column Name] FROM TABLENAME.SQL Query: This option allows you to provide a SQL query that returns a single column with object types, for example SELECT [Column Name] FROM TABLENAME. La colonna restituita deve essere di tipo stringa (varchar).The returned column must be of type string (varchar).

    Schema 2 (rilevare i tipi di attributo)Schema 2 (Detect attribute types)

    In questa pagina si configura in che modo verranno rilevati i nomi e i tipi di attributi.On this page, you are going to configure how the attribute names and types are going to be detected. Le opzioni di configurazione sono elencate per ogni tipo di oggetto rilevato nella pagina precedente.The configuration options are listed for every object type detected on the previous page.

    schema2a

    Attribute Type detection method: il connettore supporta questi metodi di rilevamento del tipo di attributo con ogni tipo di oggetto rilevato nella schermata di Schema 1.Attribute Type detection method: The Connector supports these attribute type detection methods with every detected object type in Schema 1 screen.

    • Table/View/Stored Procedure(Tabella/Vista/Stored procedure): specificare il nome della tabella/vista/stored procedure da usare per trovare i nomi di attributo.Table/View/Stored Procedure: Provide the name of the table/view/stored procedure that should be used to find the attribute names. Se si usa una stored procedure, fornire anche i relativi parametri nel formato [Nome]:[Direzione]:[Valore].If you use a stored procedure, then also provide parameters for it in the format [Name]:[Direction]:[Value]. Specificare ogni parametro su una riga separata (usare CTRL+INVIO per ottenere una nuova riga).Provide each parameter on a separate line (use Ctrl+Enter to get a new line). Per rilevare i nomi degli attributi in un attributo multivalore, fornire un elenco di tabelle o viste separate da virgole.To detect the attribute names in a multi-valued attribute, provide a comma-separated list of Tables or Views. Gli scenari multivalore non sono supportati quando le tabelle padre e figlio hanno gli stessi nomi di colonna.Multivalued scenarios are not supported when parent and child table have same column names.
    • SQL query (Query SQL): questa opzione consente di fornire una query SQL che restituisce una singola colonna con i nomi degli attributi, ad esempio SELECT [Column Name] FROM TABLENAME.SQL query: This option allows you to provide a SQL query that returns a single column with attribute names, for example SELECT [Column Name] FROM TABLENAME. La colonna restituita deve essere di tipo stringa (varchar).The returned column must be of type string (varchar).

    Schema 3 (definire ancoraggio e DN)Schema 3 (Define anchor and DN)

    Questa pagina consente di configurare l'attributo di ancoraggio e DN per ogni tipo di oggetto rilevato.This page allows you to configure anchor and DN attribute for each detected object type. È possibile selezionare più attributi per rendere univoco l'ancoraggio.You can select multiple attributes to make the anchor unique.

    schema3a

    • Non sono elencati gli attributi multivalore e booleani.Multi-valued and Boolean attributes are not listed.
    • Lo stesso attributo non può essere usato per DN e ancoraggio, a meno che nella pagina Connectivity non sia selezionata l'opzione DN is Anchor .Same attribute cannot use for DN and anchor, unless DN is Anchor is selected on the Connectivity page.
    • Se DN is Anchor è selezionata nella pagina Connectivity, questa pagina richiede solo l'attributo DN.If DN is Anchor is selected on the Connectivity page, this page requires only the DN attribute. Questo attributo verrà usato anche come attributo di ancoraggio.This attribute would also be used as the anchor attribute.

      schema3b

    Schema 4 (definire tipo di attributo, riferimento e direzione)Schema 4 (Define attribute type, reference, and direction)

    Questa pagina consente di configurare il tipo di attributo, ad esempio valore integer, binario o booleano, e la direzione per ogni attributo.This page allows you to configure the attribute type, such as integer, binary, or Boolean, and direction for each attribute. Tutti gli attributi della pagina Schema 2 sono elencati con i relativi attributi multivalore.All attributes from page schema 2 are listed including multi-valued attributes.

    schema4a

    • DataType: usato per associare il tipo di attributo ai tipi noti al motore di sincronizzazione.DataType: Used to map the attribute type to those types known by the sync engine. Per impostazione predefinita, viene usato lo stesso tipo, come rilevato in SQL schema, ma DateTime e il Reference non sono facilmente rilevabili.The default is to use the same type as detected in the SQL schema, but DateTime and Reference are not easily detectable. Per questi è necessario specificare DateTime o Reference.For those, you need to specify DateTime or Reference.
    • Direction: è possibile impostare la direzione dell'attributo su Import, Export o ImportExport.Direction: You can set the attribute direction to Import, Export, or ImportExport. ImportExport è il valore predefinito.ImportExport is default.

    schema4b

    Note:Notes:

    • Se un tipo di attributo non è rilevabile dal connettore, usa il tipo di dati stringa.If an attribute type is not detectable by the Connector, it uses the String data type.
    • Nested tables possono essere considerate tabelle di database di una colonna.Nested tables can be considered one-column database tables. Oracle archivia le righe di una tabella annidata senza un ordine particolare.Oracle stores the rows of a nested table in no particular order. Tuttavia, quando si recupera la tabella annidata in una variabile PL/SQL, alle righe vengono assegnati pedici consecutivi a partire da 1.However, when you retrieve the nested table into a PL/SQL variable, the rows are given consecutive subscripts starting at 1. In questo modo si avrà un accesso di tipo matrice alle singole righe.That gives you array-like access to individual rows.
    • VARRYS non sono supportati nel connettore.VARRYS are not supported in the connector.

    Schema 5 (definire la partizione per gli attributi di riferimento)Schema 5 (Define partition for reference attributes)

    In questa pagina si configura, per tutti gli attributi di riferimento, a quale partizione (tipo di oggetto) fa riferimento un attributo.On this page, you configure for all reference attributes which partition (object type) an attribute is referring to.

    schema5

    Se si usa DN is anchor(DN è Anchor) è necessario usare lo stesso tipo di oggetto da cui si fa riferimento.If you use DN is anchor, then you must use the same object type as the one you are referring from. Non è possibile fare riferimento a un altro tipo di oggetto.You cannot reference another object type.

    Nota

    A partire dall'aggiornamento di marzo 2017 è disponibile un'opzione per "" Quando l'opzione è selezionata, vengono importati tutti i possibili tipi di membro.Starting in the March 2017 update there is now an option for "" When this option is chosen then all possible member types will be imported.

    globalparameters3

    Importante

    A partire da maggio 2017 l'asterisco "", ovvero **qualsiasi opzione, è stato modificato per supportare il flusso di importazione ed esportazione.As of May 2017 the “” aka any option has been changed to support import and export flow. Se si desidera usare questa opzione, la tabella/vista multivalore deve avere un attributo contenente il tipo di oggetto.If you want to use this option your multi-valued table/view should have an attribute that contains the object type.


    Se si seleziona "", è necessario specificare anche il nome della colonna con il tipo di oggetto.If "" is selected then the name of the column with the object type must also be specified.

    Dopo l'importazione verrà visualizzato qualcosa di simile all'immagine riportata di seguito:After import you will see something similar to the image below:

    globalparameters3

    Global ParametersGlobal Parameters

    La pagina Global Parameters viene usata per configurare l'importazione delta, il formato di data/ora e il metodo di password.The Global Parameters page is used to configure Delta Import, Date/Time format, and Password method.

    globalparameters1

    Il connettore Generic SQL supporta i seguenti metodi per l'importazione delta:The Generic SQL Connector supports the following methods for Delta Import:

    • Trigger: vedere l'articolo relativo alla generazione di visualizzazioni delta con trigger.Trigger: See Generating Delta Views Using Triggers.
    • Watermark(Limite): approccio generico che può essere usato con qualsiasi database.Watermark: A generic approach that can be used with any database. L'opzione Water Mark Query è già popolata in base al fornitore del database.The watermark query is pre-populated based on the database vendor. In ogni tabella o visualizzazione usata deve essere presente una colonna Watermark.A watermark column must be present on every table/view used. Questa colonna deve tenere traccia di inserimenti e aggiornamenti delle tabelle, nonché delle tabelle dipendenti (multivalore o figlio).This column must track inserts and updates to the tables as and its dependent (multi-valued or child) tables. Gli orologi tra il server di database e il servizio di sincronizzazione devono essere sincronizzati.The clocks between Synchronization Service and the database server must be synchronized. In caso contrario, potrebbero essere omesse alcune voci nell'importazione delta.If not, some entries in the delta import might be omitted.
      Limitazione:Limitation:
      • La strategia Watermark (Limite) non supporta gli oggetti eliminati.Watermark strategy does not support deleted objects.
    • Snapshot(funziona solo con Microsoft SQL Server) Generating Delta Views Using SnapshotsSnapshot: (Works only with Microsoft SQL Server) Generating Delta Views Using Snapshots
    • Change Tracking(funziona solo con Microsoft SQL Server) Informazioni sul rilevamento delle modifiche (SQL Server)Change Tracking: (Works only with Microsoft SQL Server) About Change Tracking
      Limitazioni:Limitations:
      • L'attributo Anchor & DN deve essere parte della chiave primaria per l'oggetto selezionato nella tabella.Anchor & DN attribute must be part of primary key for the selected object in the table.
      • La query SQL non è supportata durante l'importazione e l'esportazione con il rilevamento delle modifiche.SQL query is unsupported during Import and Export with Change Tracking.

    Additional Parameters: specificare il fuso orario del server di database che indica dove si trova il server di database.Additional Parameters: Specify the Database Server Time Zone indicating where your Database server is located. Questo valore viene usato per supportare i diversi formati degli attributi di data e ora.This value is used to support the various formats of date & time attributes.

    Il connettore archivia sempre data e data-ora in formato UTC.The Connector always stores date and date-time in UTC format. Per poter convertire correttamente la data e ora, è necessario specificare il fuso orario del server di database e il formato usato.To be able to correctly convert the date and times, the time zone of the database server and the format used must be specified. Il formato deve essere espressa nel formato .Net.The format should be expressed in .Net format.

    Durante l'esportazione è necessario fornire al connettore ogni attributo di data e ora in formato UTC.During export every date time attribute must be provided to the Connector in UTC time format.

    globalparameters2

    Password Configuration: il connettore fornisce funzionalità di sincronizzazione password e supporta l'impostazione e la modifica della password.Password Configuration: The connector provides password synchronization capabilities and supports set and change password.

    Il connettore fornisce due metodi per supportare la sincronizzazione password:The Connector provides two methods to support password synchronization:

    • Stored Procedure: questo metodo richiede due stored procedure per supportare l'impostazione e la modifica della password.Stored Procedure: This method requires two stored procedures to support Set & Change password. Digitare tutti i parametri per aggiungere e modificare l'operazione di password nei parametri Set Password SP (Configura stored procedure password) e Change Password SP (Modifica stored procedure password), rispettivamente, come illustrato nell'esempio seguente.Type all parameters for add and change the password operation in Set Password SP and Change Password SP Parameters respectively as per below example. globalparameters3globalparameters3
    • Password Extension (Estensione password): questo metodo richiede la DLL di estensione delle password. È necessario fornire il nome della DLL di estensione che implementa l'interfaccia IMAExtensible2Password.Password Extension: This method requires Password extension DLL (you need to provide the Extension DLL Name that is implementing the IMAExtensible2Password interface). L'assembly di estensione della password deve essere inserito nella cartella dell'estensione in modo che il connettore possa caricare la DLL in fase di esecuzione.Password extension assembly must be placed in extension folder so that the connector can load the DLL at runtime. globalparameters4globalparameters4

    È anche necessario attivare la gestione delle password nella pagina Configure Extension .You also have to enable the Password Management on the Configure Extension page. globalparameters5globalparameters5

    Configurare partizioni e gerarchieConfigure Partitions and Hierarchies

    Nella pagina di configurazione di partizioni e gerarchie selezionare tutti i tipi di oggetto.On the partitions and hierarchies page, select all object types. Ogni tipo di oggetto si trova nella propria partizione.Each object type is its own partition.

    partitions1

    È anche possibile sostituire i valori definiti nella pagina Connectivity o Global Parameters.You can also override the values defined on the Connectivity or Global Parameters page.

    partitions2

    Configurare gli ancoraggiConfigure Anchors

    Questa pagina è di sola lettura perché l'ancoraggio è già stato definito.This page is read-only since the anchor has already been defined. L'attributo di ancoraggio selezionato viene sempre aggiunto con il tipo di oggetto in modo che rimanga univoco in tutti i tipi di oggetto.The selected anchor attribute is always appended with the object type to ensure it remains unique across object types.

    ancoraggi

    Configurare il parametro per l'esecuzione dei passaggiConfigure Run Step Parameter

    Questi passaggi vengono configurati nei profili di esecuzione del connettore.These steps are configured on the run profiles on the Connector. Queste configurazioni eseguono l'effettiva operazione di importazione ed esportazione dei dati.These configurations do the actual work of importing and exporting data.

    Importazione completa e deltaFull and Delta Import

    Il connettore Generic SQL supporta l'importazione completa e delta usando questi metodi:Generic SQL Connector support Full and Delta Import using these methods:

    • TabellaTable
    • VisualizzaView
    • Stored ProcedureStored Procedure
    • Query SQLSQL Query

    runstep1

    Table/ViewTable/View
    Per importare gli attributi multivalore per un oggetto, è necessario specificare il nome di tabella o vista in viste delle tabelle/nome di multivalore e condizioni di join rispettivi nel condizione Join con la tabella padre .To import multi-valued attributes for an object, you have to provide the table/view name in Name of Multi-Valued table/views and respective join conditions in the Join condition with the parent table. Se sono presenti più di una tabella a più valore nell'origine dati, è possibile utilizzare l'operatore union a una visualizzazione singola.If there are more than one multi-valued table in the data source, you can use union to a single view.

    Importante

    L'agente di gestione di SQL generico può utilizzare solo una tabella multivalore.The Generic SQL management agent can work only with one multi-valued table. Non è inserito nel nome della tabella e viste multivalore più nomi di tabella.Do not put into Name of Multi-Valued table/views more than one name of table. È la limitazione di SQL generico.It is the limitation of Generic SQL.

    Esempio: si vuole importare l'oggetto Employee e tutti i relativi attributi multivalore.Example: You want to import the Employee object and all its multi-valued attributes. Sono presenti due tabelle denominate Employee (tabella principale) e Department (multivalore).There are two tables, named Employee (main table) and Department (multi-valued). Eseguire le operazioni seguenti:Do the following:

    • Digitare Employee in Table/View/SP.Type Employee in Table/View/SP.
    • Digitare Department in Name of Multi-Valued table/views.Type Department in Name of Multi-Valued table/views.
    • Digitare la condizione di join tra Employee e Department in Join Condition (Condizione di join), ad esempio Employee.DEPTID=Department.DepartmentID.Type the join condition between Employee & Department in Join Condition, for example Employee.DEPTID=Department.DepartmentID. runstep2runstep2

    Stored procedureStored procedures
    runstep3runstep3

    • Nel caso di una grande quantità di dati, è consigliabile implementare la paginazione con le stored procedure.If you have much data, it is recommended to implement pagination with your Stored Procedures.
    • Per consentire alla stored procedure di supportare la paginazione, è necessario fornire i valori per l'inizio e la fine dell'indice.For your Stored Procedure to support pagination, you need to provide Start Index and End Index. Vedere: Paging in modo efficiente di grandi quantità di dati.See: Efficiently Paging Through Large Amounts of Data.
    • @StartIndex e @EndIndex vengono sostituiti in fase di esecuzione con il rispettivo valore di dimensione della pagina configurato nella pagina Configure Step (Passaggio di configurazione).@StartIndex and @EndIndex are replaced at execution time with respective page size value configured on Configure Step page. Ad esempio, quando il connettore recupera la prima pagina e la dimensione della pagina è impostata su 500, il valore @StartIndex sarà 1 e @EndIndex sarà 500.For example, when the connector retrieves first page and the page size is set 500, in such situation @StartIndex would be 1 and @EndIndex 500. Questi valori vengono incrementati quando il connettore recupera le pagine successive e il valore per @StartIndex e @EndIndex viene modificato.These values increase when connector retrieves subsequent pages and change the @StartIndex & @EndIndex value.
    • Per eseguire la stored procedure con parametri, specificare i parametri nel formato [Name]:[Direction]:[Value] .To execute parameterized Stored Procedure, provide the parameters in [Name]:[Direction]:[Value] format. Immettere ogni parametro su una riga separata (usare CTRL+INVIO per ottenere una nuova riga).Enter each parameter on a separate line (Use Ctrl + Enter to get a new line).
    • Il connettore Generic SQL supporta anche l'operazione di importazione dai server collegati in Microsoft SQL Server.Generic SQL connector also supports Import operation from Linked Servers in Microsoft SQL Server. Se è necessario recuperare informazioni da una tabella in un server collegato, la tabella deve essere fornita con questo formato: [ServerName].[Database].[Schema].[TableName]If information should be retrieved from a Table in Linked server, then Table should be provided in the format: [ServerName].[Database].[Schema].[TableName]
    • Il connettore Generic SQL supporta solo gli oggetti che presentano una struttura simile (sia nome alias che tipo di dati) tra le informazioni sui passaggi esecuzione e il rilevamento dello schema.Generic SQL Connector supports only those objects that have similar structure (both alias name and data type) between run steps information and schema detection. Se l'oggetto selezionato dallo schema e le informazioni fornite nel passaggio di esecuzione sono diverse, il connettore SQL non può supportare questo tipo di scenari.If the selected object from schema and provided information at run step is different, then SQL Connector is unable to support this type of scenarios.

    Query SQLSQL Query
    runstep4runstep4

    runstep5

    • Le query con più set di risultati non sono supportate.Multiple result sets queries not supported.
    • La query SQL supporta la paginazione e fornisce i valori per Start Index e End Index di una variabile per supportare la paginazione.SQL query supports the pagination and provide start Index and End Index as a variable to support pagination.

    Importazione deltaDelta Import

    runstep6

    La configurazione dell'importazione differenziale richiede un numero maggiore di operazioni di configurazione rispetto all'importazione completa.Delta Import configuration requires some more configuration compared with Full Import.

    • Se si sceglie l'approccio Trigger o Snapshot per rilevare le modifiche differenziali, specificare la tabella della cronologia o il database di snapshot nella casella History Table or Snapshot database name (Nome della tabella di cronologia o del database di snapshot).If you choose the Trigger or Snapshot approach to track delta changes, then provide History Table or Snapshot database in History Table or Snapshot database name box.
    • È necessario fornire anche una condizione di join tra la tabella della cronologia o il database di snapshot, ad esempio Employee.ID=History.EmployeeIDYou also need to provide join condition between History table and Parent table, for example Employee.ID=History.EmployeeID
    • Per tenere traccia della transazione nella tabella padre dalla tabella della cronologia, è necessario fornire il nome della colonna che contiene le informazioni sull'operazione (aggiunta/aggiornamento/eliminazione).To track the transaction on the parent table from the history table, you must provide the column name that contains the operation information (Add/Update/Delete).
    • Se si sceglie Watermark (Limite) per tenere traccia delle modifiche differenziali, è necessario fornire il nome della colonna che contiene le informazioni sull'operazione in Water Mark Column Name(Nome colonna limite).If you choose Watermark to track delta changes, then provide the column name that contains the operation information in Water Mark Column Name.
    • La colonna Change Type Attribute è necessaria per il tipo di modifica.The change Type attribute column is required for the change type. Questa colonna è associata a una modifica che si verifica nella tabella primaria o nella tabella multivalore per un tipo di modifica nella visualizzazione delta.This column maps a change that occurs in the primary table or multi-value table to a change type in the delta view. Questa colonna può contenere il tipo di modifica Modify_Attribute per la modifica a livello di attributo o un tipo di modifica Add, Modify o Delete per un tipo di modifica a livello di oggetto.This column can contain the Modify_Attribute change type for attribute-level change or an Add, Modify, or Delete change type for an object-level change type. Se è diverso dal valore predefinito per l'aggiunta, la modifica o l'eliminazione, l'utente può definire i valori usando questa opzione.If it is something other than the default value Add, Modify, or Delete, then you can define those values using this option.

    EsportazioneExport

    runstep7

    Il connettore Generic SQL supporta l'esportazione tramite quattro metodi supportati, ad esempio:Generic SQL Connector support Export using four supported methods such as:

    • TabellaTable
    • VisualizzaView
    • Stored ProcedureStored Procedure
    • Query SQLSQL Query

    Table/ViewTable/View
    (Tabella/Vista) Se si sceglie l'opzione Table/View (Tabella/Vista), il connettore genera le rispettive query per eseguire l'esportazione.If you choose the Table/View option, then the connector generates the respective queries to do the Export.

    Stored procedureStored procedures
    runstep8runstep8

    Se si sceglie l'opzione relativa alle stored procedure, l'esportazione richiede tre diverse stored procedure per eseguire le operazioni di inserimento/aggiornamento/eliminazione.If you choose the Stored Procedure option, Export requires three different Stored procedures to perform Insert/Update/Delete operations.

    • Add SP Name(Aggiungi nome stored procedure): questa stored procedure viene eseguita se un oggetto qualsiasi perviene al connettore per l'inserimento nella rispettiva tabella.Add SP Name: This SP runs if any object comes to connector for insertion in the respective table.
    • Update SP Name(Aggiorna nome stored procedure): questa stored procedure viene eseguita se un oggetto qualsiasi perviene al connettore per l'aggiornamento nella rispettiva tabella.Update SP Name: This SP runs if any object comes to connector for update in the respective table.
    • Delete SP Name(Elimina nome stored procedure): questa stored procedure viene eseguita se un oggetto qualsiasi perviene al connettore per l'eliminazione nella rispettiva tabella.Delete SP Name: This SP runs if any object comes to connector for deletion in the respective table.
    • L'attributo selezionato nello schema viene usato come valore di parametro per la stored procedure.Attribute selected from the schema used as a parameter value to the stored procedure. Ad esempio, @EmployeeName: INPUT: EmployeeName (EmployeeName viene selezionato nello schema del connettore e il connettore sostituisce il rispettivo valore durante l'esportazione)For example, @EmployeeName: INPUT: EmployeeName (EmployeeName is selected in the connector schema and the connector replaces the respective value while doing export)
    • Per eseguire la stored procedure con parametri, specificare i parametri nel formato [Name]:[Direction]:[Value] .To run parameterized stored procedure, provide parameters in [Name]:[Direction]:[Value] format. Immettere ogni parametro su una riga separata (usare CTRL+INVIO per ottenere una nuova riga).Enter each parameter on a separate line (Use Ctrl + Enter to get a new line).

    SQL querySQL query
    runstep9runstep9

    Se si sceglie l'opzione SQL query, l'esportazione richiede tre diverse query per eseguire le operazioni di inserimento/aggiornamento/eliminazione.If you choose the SQL query option, Export requires three different queries to perform Insert/Update/Delete operations.

    • Insert Query(Inserisci query): questa query viene eseguita se un oggetto qualsiasi perviene al connettore per l'inserimento nella rispettiva tabella.Insert Query: This query runs if any object comes to connector for insertion in the respective table.
    • Update Query(Aggiorna query): questa query viene eseguita se un oggetto qualsiasi perviene al connettore per l'aggiornamento nella rispettiva tabella.Update Query: This query runs if any object comes to connector for update in the respective table.
    • Delete Query(Elimina query): questa query viene eseguita se un oggetto qualsiasi perviene al connettore per l'eliminazione dalla rispettiva tabella.Delete Query: This query runs if any object comes to connector for deletion in the respective table.
    • L'attributo selezionato nello schema viene usato come valore di parametro per la query, ad esempio Insert into Employee (ID, Name) Values (@ID, @EmployeeName)Attribute selected from the schema used as a parameter value to the query, for example Insert into Employee (ID, Name) Values (@ID, @EmployeeName)

    risoluzione dei problemiTroubleshooting