Metadata Connection Wizard
Select Provider> Set Connection String> Select Qualifier> Define Metadata>Summary |
This wizard is optional and allows you to specify a connection to create metadata tables that hold all the information needed for your replication. By default, metadata is created in a Microsoft SQL Server CE database that is distributed with Syniti Replicate.
Select Provider
Metadata Name
Type a name to identify the metadata. This name appears in the Metadata Explorer as a way to group connections for a specific replication.
Database
Select the database for which you want to create a connection.
Provider
Note:Db2 running on mainframe and i (iSeries/AS400) cannot be used for the metadata connection. Choose a different database when defining your metadata connection.
Select a .NET data provider from the list. It is recommended that you use the default Microsoft SQL Server CE provider so that the metadata tables are created for the included SQL Server CE database. However, you are free to use any database you want for metadata, with the exception of IBM Db2 for i or mainframe. If no .NET provider is available for the database, select either an OLE DB provider or an ODBC driver. By default, only default providers are listed in this dialog. If you want to see all providers for a specific database, uncheck the Use Only Default Providers option in the Options dialog available from the Tools menu.
.NET providers are preferred over ODBC drivers or OLE DB providers because, with Syniti Replicate being a .NET application, it can take advantage of the use of native .NET providers based on the same architecture. If you use ODBC or OLE DB connections, the .NET framework will need to add a software layer for every call you make to the driver, adding overhead. Besides, using 100% managed .NET providers, there is no risk of memory leaks because the .NET framework cleans up memory automatically using an internal garbage collector.
Assembly
This field is displayed only if using a .NET data provider, and the provider has not been registered. Provide a path to the .NET data provider DLL.
Set Connection String
Connection Properties
Note: If you are using the default SQL Server CE .NET Provider, the Data Source field provides a drop down list where you can select an existing local SQL Server CE database or create a new local database. SQL Server CE files have a .sdf extension, and you can find a default database in your SqlServerCE folder (metadata.sdf).
For all other providers, edit at least the Required connection properties by clicking in the property value field and typing a new value. The list of Optional properties for .NET and OLE DB providers contains the most commonly used properties for the providers. Edit these as needed. Note that some properties are displayed with default values (no bold text.) Any values that you add or edit are displayed in bold text. Check the documentation for your provider for a complete list of properties. You can set the value of the ExtendedProperties property to define additional property-value pairs. The syntax for defining property-value pairs is: prop1=val1;prop2=val2;....
If you are creating the metadata tables in SQL Server, note that each login has a default initial catalog. For example, the default initial catalog for a system administrator login is "master." If you do not want to use the default catalog, be sure to enter a catalog to use in the Initial Catalog field.
If you are using an ODBC driver, click in the ConnectionString value field and then click to open the ODBC Driver Connection dialog. The contents of this dialog depend on the ODBC driver that you are using. Provide values for the dialog fields, then click OK to make a test connection and set the values in the wizard.
Edit
Click Edit to open a text entry window where you can paste or type a connection string for your provider. This is offered as an alternative to the Connection Properties grid, but should be used with great care because an error in the connection string can cause a connection to fail or to have unexpected properties. This window displays any connection information that you have already entered in connection string format. Note that default values are not displayed as part of the connection string.
Test
Click Test to make sure that the connection correctly opens a database connection.
Select Qualifer
This screen is not available if the database you have specified does not allow table qualifiers such as catalogs and schemas. If you do not select values for these fields, the default qualifiers will be used based on the connection properties provided in the Set Connection String screen.
Define Metadata
Create a new metadata database
Select this option to create metadata tables using the connection properties specified in the Set Connection String screen,
Restore the metadata set from a backup file
Select this option if you have previously saved a metadata set to a file using the Backup Metadata option.
Open existing metadata database
Select this option to use an existing metadata set available from the connection properties specified in the Set Connection String screen,
Summary
Database name
The name of the database server
Database version
The database server version
Provider type
The description of the provider that you selected in the Select provider screen.
Provider name
Whatever connection information is available for the provider you have chosen. In some cases, this field will be blank. In other cases, the provider DLL may be displayed.
Selected Qualifier
Qualifier names (if any) selected in the Select Qualifier screen.
Proceed with the definition of a source connection
When checked, the Source Connection wizard is displayed on completion of the Metadata Connection wizard. Use the Source Connection wizard to define a connection to the database that contains the tables or views you want to replicate.
Opening the Metadata Connection Wizard
In the Management Center, from the Metadata menu, choose Add New Metadata.