Supplementary Files
- Overview
- Add a file
- Download and view file
- Delete file
- Upload Oracle wallets
- Upload MySQL SSL Certificates
- Built-in seed files
Overview
You may upload supplementary SQL or Seed files to DataMasque which will be available for use by certain tasks and masks in Masking Rulesets.
Seed files provide mock datasets for use in masking and must be provided in a tabular CSV format (including a header row) encoded as UTF-8. Seed files are consumed by the following mask types:
- From file using the
seed_file
parameter.
Sample seed files are provided for download in the Sample Seed Files section.
SQL files provide scripts that DataMasque can execute during a masking run. SQL files are consumed by the following mask types:
- SQL Scripts using the
sql_file
parameter. - Temporary Tables using the
sql_select_file
parameter.
To access the supplementary file list, choose the Files item from the main menu.
Add a file
To add a file, click the button on the Files page.
A popup modal form will appear for you to fill in the following fields:
- File description (optional)
- File input, where the uploaded file must be either a CSV (Comma-Separated Values, in
.csv
or.txt
format) or SQL file
Once you have filled in the above fields, click the Submit button.
Download and view file
To download an existing file, hover over the file in the files list and click the button.
Delete file
To delete a file, hover over the file in the files list and click the button. You will be prompted for confirmation.
Upload Oracle wallets
To enable encrypted Oracle connections, you may upload one or more Oracle wallets. To upload your wallet, click the UPLOAD ORACLE WALLET button below the Files list:
Select your Oracle wallet (packaged as a .zip
file) for upload.
Each Oracle wallet .zip must have a unique filename.
To use an uploaded wallet to connect to a specific database, select it in the Add/Edit Connection interface.
Deleting and updating Oracle wallets
Oracle wallets cannot be deleted while they are referenced by a connection. To update the Oracle wallet used by one or more connections, the following process is recommended:
- Upload the new wallet (with a new/unique name)
- Update each connection to use this new wallet
- Delete the old wallet
Upload MySQL SSL Certificates
To enable encrypted connections on MySQL connections, you may upload MySQL SSL certificates. To upload your certificate, click the UPLOAD MYSQL SSL ZIP button from below the Files list:
Select your Connection Fileset, which must be packaged as a zip, for upload. Each set of certificate files must have a unique filename. For more information on what this certificate must contain, see the Encrypted Connections section for MySQL.
To use an uploaded MySQL SSL Certificate to connect to a specific database, select it as an Advanced Setting in the Add/Edit Connection interface.
Built-in seed files
The following example seed datasets are included with DataMasque.
Click each link in the table below to download:
File Name | Description | Column Headers |
---|---|---|
DataMasque_AU_addresses.csv | 31978 randomly generated AU addresses with state and postcode. | address, city, statelong, stateshort, postcode |
DataMasque_NZ_addresses_large.csv | 30,178 randomly generated NZ addresses with region and postcode. | street_name, suburb, city, region, postcode |
DataMasque_NZ_addresses_large_UTF8.csv | 30,178 randomly generated NZ addresses with region and postcode. Includes some non-ASCII characters. | street_name, suburb, city, region, postcode |
DataMasque_NZ_addresses_small.csv | 219 random New Zealand addresses with suburb and postcode. | street, suburb, city, postcode |
DataMasque_NZ_addresses_small_UTF8.csv | 219 random New Zealand addresses with suburb and postcode. Includes some non-ASCII characters. | street, suburb, city, postcode |
DataMasque_NZ_companies.csv | 236 legitimate NZ company names. | company_name |
DataMasque_US_addresses_large.csv | 48,533 randomly generated US addresses with state and postcode. | streetname, city, county, statelong, state_short, postcode |
DataMasque_US_addresses_small.csv | 5,000 randomly generated US addresses with state and postcode. | street_name, city, state, zipcode |
DataMasque_credit_card_numbers.csv | 62 magic credit card numbers with issuer name and issuer prefix. | card_number, company, prefix |
DataMasque_credit_card_prefixes.csv | 31 valid credit card prefixes. | prefix |
DataMasque_dictionary_words.csv | 971 randomly distributed dictionary words. | dictionary_words |
DataMasque_email_suffixes.csv | 101 most common email domains (with preceding @ symbol). | email-suff |
DataMasque_fake_email_suffixes.csv | 20 fictional email domains (with preceding @ symbol). | email-suff |
DataMasque_firstNames_female.csv | 23,919 randomly distributed female first names. | firstname-fem |
DataMasque_firstNames_male.csv | 14,969 randomly distributed male first names. | firstname-male |
DataMasque_firstNames_mixed.csv | 35,177 randomly distributed female and male first names. | firstname-mixed |
DataMasque_firstNames_mixed_gendered.csv | 38,888 randomly generated gendered first names. | firstname, gender |
DataMasque_languages.csv | 100 most common languages. | language |
DataMasque_lastNames.csv | 83,739 randomly distributed last names. | lastnames |
DataMasque_mixed_countries_addresses.csv | 3,000 randomly generated US, AU and NZ addresses with postcode and either suburb or state. | address, suburb, city, statelong, stateshort, post_code, country |
DataMasque_occupations.csv | 96 randomly distributed occupation titles. | occupation |
DataMasque_occupations_UTF8.csv | 96 randomly distributed occupation titles. Includes some non-ASCII characters. | occupation |
DataMasque_pasifika_names.csv | 109 Pasifika names, including names with apostrophes. | name |
DataMasque_pasifika_names_UTF8.csv | 109 Pasifika names, including names with special (non-ASCII) characters. | name |
DataMasque_short_sentences.csv | 1,442 randomly selected short sentences. | sentence |