Importing a Metadata File

If you already have metadata files, import them to GES for subsequent graph creation.

The procedure is as follows:

1. On the GES management console, click Metadata Management in the navigation tree on the left.
2. On the Metadata Management page, click Import in the upper left corner.
3. On the Import page, select Local or OBS in Type to import a metadata file form a local path or OBS.
   • Importing a metadata file from a local path

     Select Local File: Click Upload to select a local file.

     

     The file must be in the XML format.

     Name: Enter the metadata file name.

     Storage Path: Select an OBS path for storing the metadata file.

     Figure 1 Importing metadata from a local path
     
   • Importing a metadata file from OBS

     Select File Path: Select a metadata file from OBS by clicking .

     

     • The file must be in the XML format.
     • You need to upload the metadata file to your OBS bucket in advance.

     Name: Enter the metadata file name.

     Figure 2 Importing data from OBS
     
4. Click OK to import the metadata.

   After the import is complete, the metadata file is displayed on the Metadata Management page.

Creating a Metadata File

If no metadata file is available in the local path or on OBS, you can manually create metadata files.

The procedure is as follows:

1. On the Metadata Management page, click Create Metadata File in the upper right corner.
2. Configure the following parameters on the displayed page:

   Name: Enter the metadata file name. The default file format is XML.

   Storage Path: Select an OBS path for storing the metadata file. If you create metadata for the first time, you need to enable OBS. You are advised to obtain user authorization to automatically create OBS buckets for storing the metadata.

   Encrypt Metadata: This parameter determines whether to encrypt the metadata. It is disabled by default. Key Source is default to KMS. KMS Key: Select the corresponding key.

   

   Disabling or deleting a KMS key affects the instance functions.

   Definition: Detailed label definitions in the metadata file. Multiple labels can be defined in a metadata file. Click Add label to add labels as required.

   In Definition, specify the Label Name and add properties under a label. You can click Add to add properties and click Up and Down to sort the properties. Table 1 lists the property parameters. For details about other metadata information, see section Graph Data Formats.

   Figure 3 Creating a metadata file
   

   Table 1 Property parameters

   Name	Description
   Property Name	Indicates the name of a property. It contains 1 to 256 characters and cannot contain special characters such as angle brackets (<>) and ampersands (&).
   Cardinality	Indicates the composite type of data. Single value: indicates that the data of this property has a single value, such as a digit or a character string. Multiple values: indicates that data of this property consists of multiple values separated by semicolons (;). You can determine whether to allow repetitive values.
   Data Type	Indicates the data type of a property. Possible values are char, float, double, bool, long, int, date, enum, string, and char array. For details, see Table 1. NOTE: Only the single-value type supports the char array data type.
   Operation	Click Remove to delete unnecessary properties.

3. Click OK. After the metadata file is created, it will be displayed on the Metadata Management page.

Searching for a Metadata File

On the Metadata Management page, enter the name of a metadata file in the search box to search for it.

Editing a Metadata File

If the metadata file you imported or created does not meet service requirements and needs to be modified, you can modify its labels and properties online.

After the metadata file is edited, the original metadata file will be overwritten. To avoid data loss, you are advised to copy the metadata file before editing it.

The procedure is as follows:

1. GES provides two methods for you to edit a metadata file on the Data Management page.
   • Click the metadata file name. On the metadata details page, click Edit at the bottom of the page.
   • Click Edit in the Operation column of the target metadata file.
2. On the Edit page, you can add labels or properties, change the label names, and sort properties by clicking Up and Down.
3. After the modification is complete, click OK.

Copying a Metadata File

If you edit a metadata file, the original metadata file will be overwritten. To avoid loss of the original metadata file, you are advised to copy the file before editing it.

The procedure is as follows:

1. GES provides two methods for you to copy a metadata file on the Data Management page.
   • Click the metadata file name. On the metadata details page, click Copy at the bottom of the page.
   • Click Copy in the Operation column of the target metadata file.
2. Define the metadata file name and storage path.

   Name: Enter the name of the copied metadata file. The default file format is XML.

   Storage Path: Enter the OBS path for storing the metadata file.

   Encrypt Metadata: This parameter determines whether to encrypt the copied metadata. It is disabled by default. Key Source is default to KMS. KMS Key: Select the corresponding key.

   Figure 4 Copying a metadata file
   
3. Click OK.

   After the file is copied, the new metadata file will be displayed on the Metadata Management page.

Deleting a Metadata File

If a metadata file becomes invalid, locate it in the metadata file list and click Delete in the corresponding Operation column to delete it on the Metadata Management page.

The deleted data cannot be recovered. Exercise caution when performing this operation.