Synonyms constitute the metadata that DataMigrator requires to define unique names (or aliases) for each table or view that is accessible from the server. A synonym must be created for every table that DataMigrator accesses.
Once you have created the metadata (synonym), it is a good idea to test it to make sure that the data is available for DM processing.
You can also create and test metadata from the Managing Metadata page of the Web Console. For more information, see the Server Administration manual or the Web Console online help.
The Select adapter to configureconnection dialog box opens, showing the adapters that you have configured.
The Select Synonym CandidatesAvailable Objects dialog box opens, as shown in the following image.
Note: The contents of this dialog box will depend on the adapter selected.
The Create Synonym dialog box opens, as shown in the following image, showing all objects that meet the specified criteria.
When synonyms already exist, you can select the Update or SelectUpdate Base Synonyms option. If you select UpdateUpdate Base Synonyms from the Update or Create MetadataAction drop-down menu, you have the option of selecting which attributes to update. For more information, see How to Update a Synonym.
Note: If the cardinality of the tables to be used in the application is dynamic, it may not be beneficial to choose this setting.
If this option is selected, column data is retrieved dynamically from the data source at the time of the request.
To select all tables or views in the list, select the check box to the left of the Default Synonym Name column heading.
To select specific tables or views, select the corresponding check boxes.
Synonyms are created and added under the specified application directory.
The status field of the Create Synonym window shows that the synonyms were created successfully.
If you create a synonym for a relational stored procedure, you can use that stored procedure as a data source in a flow. When you create the synonym, you will be prompted for values for the parameters of the procedure.
We are using Oracle as an example for this procedure.
The Select Synonym Candidates (Step 1) dialog box opens.
The Select Synonym Candidates (Step 2) dialog box opens.
The Select Synonym Candidates (Step 3) dialog box opens.
Note: Values entered are used only when creating the synonym and are not saved.
A confirmation message appears.
The synonym now appears in the navigation pane listed under the application directory it was created in.
To update a synonym from the Select Synonym CandidatesAvailable Objects dialog box:
The Update Synonyms dialog box opens, as shown in the following image.
The selected synonym will now be updated
Note: If the synonyms are not listed, on the Home tab, from the Filter group, click Synonyms.
The Create Tutorial Framework dialog box opens, as shown in the following image.
Note: The WebFOCUS and Legacy sample tables and files are not used with DataMigrator.
The Retail Demo option loads tables with a pre-determined amount of data designed for WebFOCUS reports.
For the Prefix for SQL Tables field, use the default value unless you have a reason to avoid tables starting with the indicated default. If so, type a different value.
When the creation process is complete, a confirmation message appears. The message will depend on the type of samples you create, for example, DataMigrator - General, DataMigrator - Iterator, DataMigrator - File Listener, or DataMigrator - Star Schema.
The message also displays in the Console Log.
The procedures and synonyms appear in the ibisamp application directory, which is created and added to the server search path during installation. For FOCUS, the sample data is also stored in ibisamp. For other adapters, it is stored in the database of the configured adapter. The source data for the file listener flow is stored in ibisamp in four files with names starting with dmord and an extension of data.
Note: By default, column names are created in the database with UPPER CASE column names. This is problematic for databases, such as PostgreSQL and those based on it such as Greenplum, where column names are expected to be in lower case.
The Change Settings dialog box opens.
This setting is also used by DataMigrator when creating new tables.
The Create Tutorial Framework dialog box opens. Your display will depend on the specific adapters you have configured.
For the Prefix for SQL Tables field, use the default value unless you have a reason to avoid tables starting with the indicated default. If so, type a different value.
Star Schema sample procedures created for database
where:
indicates the database type you have selected.
The procedures and synonyms appear in the ibisamp application directory, which is created and added to the server search path during installation.
From the DMC:
The Create Tutorial Framework dialog box opens. Your display will depend on the specific adapters you have configured.
For the Prefix for SQL Tables field, use the default value unless you have a reason to avoid tables starting with the indicated default. If so, type a different value.
The Create Tutorial Framework dialog box opens. Your display will depend on the specific adapters you have configured.
For the Prefix for SQL Tables field, use the default value unless you have a reason to avoid tables starting with the indicated default. If so, type a different value.
Sample procedures created for database
where
Indicates the database type you have selected.
The procedures and synonyms appear in the ibisamp application directory, which is created and added to the server search path during installation.
Right-click the dmplntpf flow and click Submit.
WebFOCUS | |
Feedback |