Managing Sample Libraries

Prerequisites

A sample file has been uploaded to OBS or HDFS. The sample file must be in TXT format. It is recommended that the file be no larger than 10 MB. Data in the file can be separated by line breaks (\n), spaces, commas (,), or vertical bars (|).

Notes and Constraints

• When creating a random or character replacement masking algorithm, if you select Sample library for Random Mode or Replacement Mode, the sample file for testing the algorithm cannot be larger than 10 KB. This restriction applies only to the algorithm test and does not apply to real static masking tasks.
• It is recommended that a sample file be no larger than 10 MB. Otherwise, static masking tasks for which the sample file needs to be parsed may fail.
• OBS sample files can only be used for static DLI data masking tasks and HDFS sample files can only be used for static MRS data masking tasks. For details about the mapping between static masking scenarios and engines, see Reference: Static Data Masking Scenarios.

Creating a Sample

1. On the DataArts Studio console, locate a workspace and click DataArts Security.
2. In the navigation pane on the left, choose Sample Libraries.
   Figure 1 Sample Libraries page
   

3. On the Sample Libraries page, click in the directory, move the cursor to the directory, click , and enter a classification name to add a sample library classification. The classification name can contain a maximum of 64 characters, including only letters, digits, and underscores (_). The excess part, if any, will be truncated. A maximum of 10 layers of sample library classifications (except the All layer) are supported.
   Figure 2 Adding a sample library classification
   

4. In the right pane, click Create. The classification selected on the left is set for Classification in the Create dialog box.
   Figure 3 Creating a sample
   

5. In the displayed dialog box, set the parameters listed in Table 1 and click Confirm.
   Figure 4 Creating a sample
   

   Table 1 Parameters for creating a sample

   Parameter	Description
   *Name	Sample name. It can contain a maximum of 64 characters, including only letters, digits, and underscores (_). The excess part, if any, will be truncated.
   Description	A description of the sample to be created, which can contain a maximum of 1,024 characters.
   *Classification	The classification selected on the left is entered by default. You can also click it to select another classification.
   *Sample Libraries	Select a sample file that has been uploaded to OBS or HDFS. The sample file must be in TXT format. It is recommended that the file be no larger than 10 MB. Data in the file can be separated by line breaks (\n), spaces, commas (,), or vertical bars (|). OBS sample files can only be used for static DLI data masking tasks and HDFS sample files can only be used for static MRS data masking tasks. For details about the mapping between static masking scenarios and engines, see Reference: Static Data Masking Scenarios.
   *Delimiter	Delimiter of data in the sample file, which can be a link break (\n), space, comma (,), or vertical bar (|)

Related Operations

• Editing a sample library classification: On the Sample Libraries page, click , move the cursor to the classification to be edited, click , and edit the classification name.
• Deleting a sample library classification: On the Sample Libraries page, click , move the cursor to the classification to be edited, and click .

  Sample library classifications that contain samples cannot be deleted. The All root classification cannot be deleted either.

  NOTE:

  The deletion operation cannot be undone. Exercise caution when performing this operation.

• Editing a sample: On the Sample Libraries page, locate a sample and click Edit in the Operation column to modify parameters of the sample.
• Deleting a sample: On the Sample Libraries page, locate a sample and click Delete in the Operation column to delete the sample.
  Samples being used by masking algorithms cannot be deleted. To delete such samples, cancel the reference first.

  NOTE:

  The deletion operation cannot be undone. Exercise caution when performing this operation.