All Products
Search
Document Center

Data Management:View table details

Last Updated:Apr 07, 2024

To fully understand and efficiently use table data, you can view the details of a table on the SQL Console tab of Data Management (DMS). The table details include technical metadata such as the database to which the table belongs, fields, indexes, and number of rows, business metadata such as the category and table description, and management metadata such as the table permissions and table owner.

Background information

DMS provides the metadata of a table to help developers and business staff understand the relationships between upstream and downstream data and the purpose of the data in the table. This saves time for understanding data and allows users to find the required data in a precise manner. This also improves development and management efficiency.

DMS provides the following types of metadata for a table:

  • Technical metadata: the physical information about the table in the database, such as the instance and database to which the table belongs, table name, comments, fields, indexes, character sets, number of rows, data size, data lineage, task information, and data quality.

  • Business metadata: the business information that is used to describe and manage the table, such as the tags, category, and description of the table, the description of each field, and usage notes.

  • Management metadata: the information that is used to manage the table in DMS, such as the permissions, row-level access control, and owner of the table.

Prerequisites

  • The database instance to be managed is a relational database or a data warehouse. For more information, see Supported database types and features.

  • The instance is managed in Security Collaboration mode. For more information, see Control modes.

  • One of the following conditions is met:

    • You are a DMS administrator or a database administrator (DBA) in DMS. Alternatively, you are assigned the schema read-only role. For more information, see System roles.

    • You are the owner or the DBA of the database instance that you want to manage. For more information, see Modify database instances.

    • You have the permissions to query, change, or export the data of the database instance that you want to manage or a table in the database instance. For more information, see View owned permissions.

Procedure

  1. Log on to the DMS console V5.0.
  2. Go to the details page of a table. You can use one of the following methods to go to the details page of a table:

    • Go to the Data Visualization tab from the SQL Console tab

      1. In the top navigation bar of the DMS console, choose SQL Console > SQL Console.

      2. In the Please select the database first dialog box, enter a keyword to search for the database instance that you want to manage, select the database instance from the search results, and then click Confirm.

      3. In the upper-right corner of the SQL Console tab, click the 表详情 icon in the extended feature section.

      4. Find the table that you want to view, move the pointer over More in the Actions column, and then select View Table Details. The Details panel appears.

    • Search for the table that you want to view

      1. In the top navigation bar, click Home. In the search box, enter the name of the table that you want to view.

      2. In the search results, click the Table option. Find the table that you want to view and click Details on the right to go to the Tables page.

  3. On the Tables page, perform relevant operations based on your business requirements.

    Table 1 Elements on the Tables page

    Section

    Description

    Table overview

    • Character Set: the character set of the table.

    • Rows: the number of rows in the table.

    • Capacity (MB): the storage space occupied by the table.

    • Environment: the environment type of the database instance to which the table belongs, such as the development or test environment. For more information, see Change the environment type of an instance.

    • DB Information: the database instance to which the table belongs.

    • Permission: the permissions that you have on the table.

    • Data Owner: the owner of the table.

    • Tag: the tags of the table. You can add one or more phrases as tags for classification.

    • Description: the comments on the table.

    • Business Description: the business description of the table. The description can be up to 1,000 characters in length. This can help relevant users understand the purpose of the table.

    • Category: the category of the table. You can select a category for the table in a category tree. For more information, see Use the asset category feature.

    Basic Information

    • Field Information:

      The Field Information tab displays the basic information about each field in the table, such as the field name, data type, description, sensitivity level, sensitivity level source, and business description.

      Note

      If you are the owner of the table, a DMS administrator, or a DBA, you can modify the business description of each field. To modify the business description of a field, find the field and double-click the description in the Business Description column.

      You can also perform the following operations:

      • Generate a SELECT Statement: View the SELECT statement that is used to query all fields in the table.

      • Export Schema: View the schema of the table in the format of a data dictionary. You can export the schema in the form of a Word, Excel, or PDF file.

      • Generate a DDL Statement: View the complete DDL statement that is used to create the table.

      • Security Level Adjustment: Change the sensitivity level of one or more fields. For more information, see Adjust the sensitivity level of one or more fields.

      • Code Generator: Generate code in various formats.

    • Index:

      The Index tab displays the name, type, included columns, and remarks for each index.

    • Row-level Control:

      The Row-level control tab displays the information about control fields. To view the details of a control field, click Control Value Details in the Actions column.

    Data Lineage

    When you use the task orchestration feature to synchronize and process the data of the table, the data flows.

    The Data Lineage tab displays how data flows from tables to tables or from fields to fields. This tab helps you fully understand upstream and downstream data. This can help you resolve issues about data governance, such as repeated data processing and unauthorized use of data. In addition, data lineage also helps you minimize the impact caused by data changes.

    To view the upstream and downstream of a table or a field, click the 查看数据血缘图标.png icon on the left and right sides of the table or field. The upstream data is displayed on the left side, and the downstream data is displayed on the right side.

    Version Management

    The Historical Versions tab displays the schema versions of the table. You can also perform the following operations:

    • Preview script: Preview the SQL script that is used to generate the schema version.

    • Table structure comparison: Synchronize the schema version to another database, or compare the schema version with a schema version in another database. For more information, see Synchronize schemas.

    • Structural recovery: Synchronize the schema version that you want to restore to an empty database. For more information, see Initialize empty databases.

    Task Information

    If you use the task orchestration feature to write data to the table, you can view the information about each task, such as the task name, task ID, start time, duration, and end time.

    You can also perform the following operations:

    • Click Code to view the code of the task on the task orchestration page.

    • Click Log to view the operational logs of the task.

    Data Preview

    On the Data Preview tab, you can view the first 50 data entries in the table.

    Note

    To view data entries, you must have the permissions to query the data of the table or the database instance to which the table belongs. For more information, see View owned permissions.

    Data quality

    On the Data quality tab, you can create quality rules for the table. Then, you can use the quality rules on the task orchestration page to check whether the data of the table is valid. This improves data quality. For more information, see Check the data quality.

    Instructions for Use

    On the Instructions for Use tab, you can enter the usage notes and additional information about the table that help other users understand and use the table. The Markdown syntax is supported.

    Note

    All users can view the information that you enter, but only DMS administrators, DBAs, or the table owner can modify the information.