Load example datasets

From Fusion Registry Wiki
Revision as of 02:10, 23 September 2020 by Glenn (talk | contribs) (Load the EXR Exchange Rates data)
Jump to navigation Jump to search

Overview

Fusion Registry is a 'virtual statistical data warehouse' meaning that the data it contains can either be loaded and held in storage managed by Fusion Registry, or retrived dynamically from external sources like SQL databases, SDMX REST web services or files.

In this example, we are going to load some data from the ECB's EXR Exchange Rate dataset into Fusion Registry.

We first need to prepare the Dataflow to receive data:

  • Add a connection to our MySQL database to store the data
  • Create an SDMX Data Provider - this is the 'organisation' under which the data will be submitted under the SDMX Data Collection model
  • Create an SDMX Provision Agreement - this is the SDMX structure which authorises the Data Provider to submit data to the Dataflow
  • Link the Provision Agreement to the MySQL database connection

Once the Dataflow has been prepared, the data will be loaded directly from Metadata Technology's Fusion Registry demononstration service.

Add a database connection for data storage

AddDatabaseConnection.PNG
  • Login to the admin account
  • From the left-hand menu choose Admin > Data Manager
  • Choose the Cogs.PNG 'cogs' button and select Add Database Connection from the menu
  • Use the following settings:
    • Connection Id: MYSQL_LOCAL
    • Connection Type: Registry Managed
    • Database Cache: None
    • Database Platform: MySQL
    • Connection Settings: Simple
    • Database Server: localhost
    • Database Port: 3306
    • Database Schema: fusion_registry (or the name of the schema you created)
    • Database Username: (the name of the database user with access to the schema)
    • Database Password: (the password for that database user)

The 'MYSQL_LOCAL' connection Id will be used later when configuring the Provision Agreement.

Create an SDMX Data Provider

DataProviderWizard.PNG
  • Login to the admin account (if not already logged in)
  • From the left-hand menu choose Organisations > Data Providers
  • Choose the Cogs.PNG 'cogs' button and select Create Data Provider
  • Under the 1 Details step of the wizard:
    • Id: MYDP
    • Language: en (this is the language for the Name and Description - you can choose other languages, but we will work with English for now)
    • Owning Agency: SDMX
    • Name: My Data Provider (you can choose any name you like)
    • Description: A test Data Provider (again, you can choose your own description)
  • Choose the Finish button

Create an SDMX Provision Agreement

DataflowWizardStep3.PNG
  • Login to the admin account (if not already logged in)
  • From the left-hand menu choose Data > Dataflows
  • Select the 'EXR' EXB Exchange Rates Dataflow from the list
  • Choose the Cogs.PNG 'cogs' button and select Edit Selected Dataflow
  • On the Dataflow Wizard, use the Next button to move to Step 3 - Data Providers
  • Use the AddButton.PNG button to add a new Data Provider for the Dataflow
  • When the Choose Data Providers window appears, check the MYDP Data Provider and choose the Add button
  • Back on the Dataflow Wizard, choose the Finish button to save the changes

Link the Provision Agreement to the database connection

ProvisionAgreementsDataSource.PNG
  • Login to the admin account (if not already logged in)
  • From the left-hand menu choose Data > Provision Agreements
  • Select the 'EXR_SDMX_MYDP' Provision Agreement from the list
  • Locate the Linked Data Source field at the bottom of the page - choose 'MYSQL_LOCAL' in the select box, and click the Apply button

Load the EXR Exchange Rates data

LoadDataFromUrl.PNG
  • Login to the admin account (if not already logged in)
  • From the left-hand menu choose Data > Load Data
  • On the Load Data page:
    • Data Source: Load from URL
    • Data Format: Auto Detect
    • Data Structure: Auto Detect
    • Data URL: https://demo.metadatatechnology.com/FusionRegistry/ws/public/sdmxapi/rest/data/ECB,EXR,1.0/all?format=sdmx-compact-2.1
    • Choose the Load Data button