数据目录视图

与自治 AI 数据库的数据目录集成提供了许多表和视图。

这些表和视图可帮助您理解:

ALL_CLOUD_CATALOG_DATABASES 视图

使用视图 ALL_CLOUD_CATALOG_DATABASES 显示有关 OCI 数据目录数据资产和 AWS Glue 数据目录数据库的信息。

说明
DCAT_CON_ID CON1
CATALOG_ID 数据目录唯一标识符。

OCI 数据目录示例:

ocid1.datacatalog.oc1.ap-mumbai-1.....y35a

AWS Glue 数据目录示例:

NULL

579294766787

NAME 数据资产 (OCI)/数据库 (AWS Glue) 的名称。

OCI 数据目录示例:

OBJECT_STORE_AT_ASHBURN

AWS Glue 数据目录示例:

OBJECT_STORE_AT_N_CALIFORNIA

DESCRIPTION 数据资产 (OCI)/数据库 (AWS Glue) 的说明。

OCI 数据目录示例:

Data stored in S3 (N. California)

AWS Glue 数据目录示例:

Data stored in S3 (N. California)

TIME_CREATED 在数据目录中创建数据资产 (OCI)/数据库 (AWS Glue) 的日期和时间。

OCI 数据目录示例:

26-SEP-22 10.56.01.395000 PM +00:00

AWS Glue 数据目录示例:

2022-06-15T09:45:35+01:00

DETAILS 包含有关每个数据实体 (OCI)/数据库 (AWS Glue) 的元数据的 JSON 文档。

OCI 数据目录示例:

{ "catalog-id": "ocid1.datacatalog.oc1.ap-mumbai-1.amaaa...", "description": null, "display-name": "OBJECT_STORE_AT_ASHBURN", "external-key": "https://swiftobjectstorage.us-ashburn-1....", "key": "bc95181c-3ac3-4959-9e5f-4e460d3fb82a", "lifecycle-state": "ACTIVE", "time-created": "2022-09-26T22:56:01.395000+00:00", "type-key": "3ea65bc5-f60d-477a-a591-f063665339f9", "uri": "/dcat/20190325/dataAssets/bc95181c-3ac3-4959-9e5f-4e460d3fb82a" }

AWS Glue 数据目录示例:

{ "Name": "dbmsdcatpoc", "Parameters": { "somekey": "somevalue" }, "CreateTime": "2022-06-15T09:45:35+01:00", "CreateTableDefaultPermissions": [ { "Principal": { "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS" }, "Permissions": [ "ALL" ] } ], "CatalogId": "579294766787" }

ALL_CLOUD_CATALOG_TABLES 视图

View ALL_CLOUD_CATALOG_TABLES 用于显示有关 OCI 数据目录的数据实体的信息以及 AWS Glue 数据目录的表。

说明
DCAT_CON_ID 数据目录的唯一标识符。连接 ID。

OCI 数据目录示例:CON1

AWS Glue 数据目录示例:CON1

CATALOG_ID 数据目录唯一标识符。

OCI 数据目录示例:ocid1.datacatalog.oc1.ap-mumbai-1.....y35a

AWS Glue 数据目录示例:NULL

579294766787

DATABASE_NAME 数据资产 (OCI)/数据库 (AWS Glue) 的名称。

OCI 数据目录示例:OBJECT_STORE_AT_ASHBURN

AWS Glue 数据目录示例:OBJECT_STORE_AT_N_CALIFORNIA

NAME 数据实体 (OCI)/表 (AWS Glue) 的名称。

OCI 数据目录示例:BIKES_TRIPS

AWS Glue 数据目录示例:BIKES_TRIPS

DESCRIPTION 数据实体 (OCI)/表 (AWS Glue) 的说明。

OCI 数据目录示例:Table storing bike trips

AWS Glue 数据目录示例:Table storing bike trips

TIME_CREATED 在数据目录中创建数据实体 (OCI)/表 (AWS Glue) 的日期和时间。

OCI 数据目录示例:26-SEP-22 10.56.01.395000 PM +00:00

AWS Glue 数据目录示例:2022-06-15T09:45:35+01:00

TIME_UPDATED 上次对数据实体 (OCI)/表 (AWS Glue) 进行更改的时间。

OCI 数据目录示例:26-SEP-22 10.56.01.395000 PM +00:00

AWS Glue 数据目录示例:2022-06-15T09:45:35+01:00

DETAILS 包含每个数据实体 (OCI)/表的元数据 (AWS Glue) 的 JSON 文档

OCI 数据目录示例:

{  "business-name": null, "data-asset-key": "bc95181c-3ac3-4959-9e5f-...", "description": null, "display-name": "bikes_trips", "external-key": "LE: https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/..._trips", "folder-key": "9c4b542d-d6eb-4b83-bf59-...", "folder-name": "hive", "is-logical": true, "is-partition": false, "key": "fde30a69-a07c-478a-ab62-...", "lifecycle-state": "ACTIVE", "object-storage-url": "https://objectstorage.us-ashburn-1.oraclecloud.com/n/...", "path": "OBJECT_STORE_AT_ASHBURN/hive/hive", "pattern-key": "db21b3f1-1508-4045-aa80-...", "properties": { "default": { "CONTENT-LENGTH": "4310321", "LAST-MODIFIED": "Fri, 9 Oct 2020 20:16:52 UTC", "archivedPECount": "0", "dataEntityExpression": "{logicalEntity:[^/]+}.db/{logicalEntity:[^/]+}/.*", "harvestedFile": "bikes.db/trips/p_start_month=2019-09/000000_0", "patternName": "bikes_trips" }, "harvestProps": { "characterset": "UTF8", "compression": "none", "type": "PARQUET" } }, "realized-expression": "bikes.db/trips/.*", "time-created": "2022-09-26T22:56:35.063000+00:00", "time-updated": "2022-09-26T22:56:35.063000+00:00", "type-key": "6753c3af-7f88-44b9-be52-1d57bef462fb", "updated-by-id": "ocid1.user.oc1..r5l3tov7a", "uri": "/dcat/20190325/dataAssets/bc95181c-3ac3-4959-9e5f-..." }

AWS Glue 数据目录示例:

{ "Name": "bikes_trips", "DatabaseName": "dbmsdcatpoc", "Owner": "owner", "CreateTime": "2022-06-23T13:24:20+01:00", "UpdateTime": "2022-06-23T13:24:20+01:00", "LastAccessTime": "2022-06-23T13:24:20+01:00", "Retention": 0, "StorageDescriptor": { "Columns": [ { "Name": "trip_duration", "Type": "int" }, { "Name": "start_month", "Type": "string" }, ... ], "Location": "s3://dbmsdcatpoc/hive/bikes.db/trips/", "InputFormat": "org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat", "OutputFormat": "org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat", "Compressed": false, "NumberOfBuckets": -1, "SerdeInfo": { "SerializationLibrary": "org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe", "Parameters": { "serialization.format": "1" } }, "BucketColumns": [], "SortColumns": [], "Parameters": { "CrawlerSchemaDeserializerVersion": "1.0", "CrawlerSchemaSerializerVersion": "1.0", "UPDATED_BY_CRAWLER": "crawler-bikes", "averageRecordSize": "86", "classification": "parquet", "compressionType": "none", "objectCount": "12", "recordCount": "404947", "sizeKey": "35312159", "typeOfData": "file" }, "StoredAsSubDirectories": false }, "PartitionKeys": [ { "Name": "p_start_month", "Type": "string" } ], "TableType": "EXTERNAL_TABLE", "Parameters": { "CrawlerSchemaDeserializerVersion": "1.0", "CrawlerSchemaSerializerVersion": "1.0", "UPDATED_BY_CRAWLER": "crawler-bikes", "averageRecordSize": "86", "classification": "parquet", "compressionType": "none", "objectCount": "12", "recordCount": "404947", "sizeKey": "35312159", "typeOfData": "file" }, "CreatedBy": "arn:aws:sts::579294766787:assumed-role/AWSGlueServiceRole-dbmsdcat/AWS-Crawler", "IsRegisteredWithLakeFormation": false, "CatalogId": "579294766787", "VersionId": "0" }

范例

ALL_DCAT_ASSETS 视图

此数据库有权访问的数据目录资产。

数据类型 说明
DCAT_CON_ID VARCHAR2 (4000) 在实例中唯一的连接标识符
KEY VARCHAR2(4000) 资产关键字
DISPLAY_NAME VARCHAR2(4000) 资产显示名称
DESCRIPTION VARCHAR2(4000) 资产说明
CATALOG_ID VARCHAR2(4000) 包含资产的数据目录的 OCID
EXTERNAL_KEY VARCHAR2(4000) 资产的基本对象存储 URI
URI VARCHAR2(4000) 数据目录 API 的资产 URI
TIME_CREATED TIMESTAMP(6) WITH TIMEZONE 数据资产的创建日期和时间
TYPE_KEY VARCHAR2(4000) 数据资产类型的键(目前仅支持对象存储数据资产)。类型关键字可以通过“/类型”数据目录端点找到。
LIFECYCLE_STATE VARCHAR2(4000) 数据资产的当前状态。有关可能的生命周期状态的更多信息,请参阅数据目录 DataAsset Reference 以获取 lifecycleState 的可能状态的列表。

ALL_DCAT_ATTRIBUTES 视图

此数据库有权访问的数据目录属性。

数据类型 说明
DCAT_CON_ID VARCHAR2 (4000) 在实例中唯一的连接标识符
KEY NUMBER 属性关键字
DISPLAY_NAME VARCHAR2(4000) 属性的显示名称
BUSINESS_NAME VARCHAR2(4000) 属性业务名称
DESCRIPTION VARCHAR2(4000) 属性描述
DATA_ASSET_KEY VARCHAR2(4000) 数据资产密钥
FOLDER_KEY VARCHAR2(4000) 文件夹键
ENTITY_KEY VARCHAR2(4000) 实体键
EXTERNAL_KEY VARCHAR2(4000) 属性的唯一外部关键字
LENGTH NUMBER 属性值允许的最大长度
PRECISION NUMBER 属性值的精确度(通常应用于浮点数据类型)
SCALE NUMBER 属性值的比例(通常应用于浮点数据类型)
IS_NULLABLE NUMBER 确定是否可为此属性分配空值
URI VARCHAR2(4000) 数据目录 API 中属性实例的 URI
LIFECYCLE_STATE VARCHAR2(4000) 属性的当前状态。有关可能的生命周期状态的更多信息,请参阅数据目录属性参考,以了解 lifecycleState 的可能状态列表。
TIME_CREATED TIMESTAMP(6) WITH TIME ZONE 创建属性的日期和时间
EXTERNAL_DATA_TYPE VARCHAR2(4000) 在外部系统中定义的属性的数据类型
MIN_COLLECTION_COUNT NUMBER 最小元素数(如果属性类型为集合类型)
MAX_COLLECTION_COUNT NUMBER 最大元素数(如果属性类型是集合类型)
DATATYPE_ENTITY_KEY VARCHAR2(4000) 表示此属性的数据类型的实体键,如果此属性是复杂类型,则适用
EXTERNAL_DATATYPE_ENTITY_KEY VARCHAR2(4000) 表示此属性的数据类型的外部实体键,如果此属性是复杂类型,则适用
PARENT_ATTRIBUTE_KEY VARCHAR2(4000) 表示此属性的父属性的属性关键字,如果父属性的数据类型为复杂,则适用
EXTERNAL_PARENT_ATTRIBUTE_KEY VARCHAR2(4000) 表示此属性的父属性的外部属性关键字,如果父属性属于复杂类型,则适用
PATH VARCHAR2(4000) 属性的完整路径

ALL_DCAT_CONNECTIONS 视图

包含有关连接到此实例的数据目录的信息的视图。

数据类型 说明
DCAT_CON_ID VARCHAR2(4000) 在实例中唯一的连接标识符
COMPARTMENT_ID VARCHAR2(4000) 数据目录实例所在的区间的 OCID
INSTANCE_ID VARCHAR2(4000) 数据目录实例的 OCID
REGION VARCHAR2(4000) 数据目录实例的区域
ENDPOINT VARCHAR2(4000) 数据目录实例的端点
CREATED TIMESTAMP 创建数据目录实例的时间
NAME VARCHAR2(4000) 数据目录实例的名称
LAST_UPDATED TIMESTAMP 上次更新到数据目录实例的连接的时间戳
LATEST_OPERATION_ID NUMBER 上次同步操作的 ID
DATA_CATALOG_CREDENTIAL VARCHAR2(128) 用于访问数据目录的身份证明
OBJECT_STORE_CREDENTIAL VARCHAR2(128) 外部表驱动程序用于访问对象存储的身份证明

ALL_DCAT_ENTITIES 视图

此数据库有权访问的“数据目录”逻辑实体。

数据类型 说明
DCAT_CON_ID VARCHAR2(4000) 在实例中唯一的连接标识符
CATALOG_ID VARCHAR2(4000) 包含资产的数据目录的 OCID
KEY VARCHAR2(4000) 实体键
DISPLAY_NAME VARCHAR2(4000) 实体显示名称
BUSINESS_NAME VARCHAR2(4000) 实体业务名称
DESCRIPTION VARCHAR2(4000) 逻辑实体说明
DATA_ASSET_KEY VARCHAR2(4000) 资产关键字
FOLDER_KEY VARCHAR2(4000) 文件夹唯一键
FOLDER_NAME VARCHAR2(4000) 文件夹名称(存储桶)
EXTERNAL_KEY VARCHAR2(4000) 逻辑实体的外部关键字
PATTERN_KEY VARCHAR2(4000) 逻辑实体的关联模式的关键字
REALIZED_EXPRESSION VARCHAR2(4000) 用于获取此逻辑实体的文件的正则表达式
PATH VARCHAR2(4000) 逻辑实体的完整路径
TIME_CREATED TIMESTAMP(6) WITH TIME ZONE 创建实体的日期和时间
TIME_UPDATED TIMESTAMP(6) WITH TIME ZONE 上次对数据实体进行更改的时间
UPDATED_BY_ID VARCHAR2(4000) 数据目录中更新此对象的用户的 OCID
URI VARCHAR2(4000) API 中实体实例的 URI
LIFECYCLE_STATE VARCHAR2(4000) 实体的当前状态。有关可能的生命周期状态的更多信息,请参阅数据目录实体参考,以了解 lifecycleState 的可能状态列表。

ALL_DCAT_FOLDERS 视图

对象存储存储桶的元数据,这些存储桶包含逻辑实体的数据文件。

数据类型 说明
DCAT_CON_ID VARCHAR2(4000) 在实例中唯一的连接标识符
CATALOG_ID VARCHAR2(4000) 包含资产的数据目录的 OCID
KEY VARCHAR2(4000) 文件夹键
DISPLAY_NAME VARCHAR2(4000) 文件夹显示名称
BUSINESS_NAME VARCHAR2(4000) 文件夹业务名称
DESCRIPTION VARCHAR2(4000) 文件夹说明
DATA_ASSET_KEY VARCHAR2(4000) 包含文件夹的数据资产的关键字
PARENT_FOLDER_KEY VARCHAR2(4000) 父文件夹的键(当前,这是数据资产键)
PATH VARCHAR2(4000) 文件夹的完整路径
EXTERNAL_KEY VARCHAR2(4000) 存储桶的对象存储 URI
TIME_EXTERNAL TIMESTAMP(6) WITH TIMEZONE 此文件夹的上次修改时间戳
TIME_CREATED TIMESTAMP(6) WITH TIMEZONE 创建此文件夹的日期/时间
URI VARCHAR2(4000) 数据目录 API 中文件夹实例的 URI。
LIFECYCLE_STATE VARCHAR2(4000) 文件夹的当前状态。有关可能的生命周期状态的更多信息,请参阅数据目录文件夹参考,以了解 lifecycleState 的可能状态列表。

ALL_DCAT_GLOBAL_ACCESSIBLE_CATALOGS 视图

此视图列出所有区域中所有可访问的目录,以及每个目录的访问权限级别。

数据类型 说明
CATALOG_ID VARCHAR2(4000) 目录 OCID
CATALOG_NAME VARCHAR2(4000) 目录的名称
CATALOG_REGION VARCHAR2(4000) 目录区域的名称
CATALOG_SCORE NUMBER 目录得分是根据为数据目录访问身份证明配置的权限计算得出的数值。目录评分越高,权限就越大,这可能相当于此目录用于此自治 AI 数据库实例的可能性越大。

ALL_DCAT_LOCAL_ACCESSIBLE_CATALOGS 视图

此视图列出当前区域中的所有可访问目录,以及每个目录的访问权限级别。

数据类型 说明
CATALOG_ID VARCHAR2(4000) 目录 OCID
CATALOG_NAME VARCHAR2(4000) 目录的名称
CATALOG_SCORE NUMBER 目录得分是根据为数据目录访问身份证明配置的权限计算得出的数值。目录评分越高,权限就越大,这可能相当于此目录用于此自治 AI 数据库实例的可能性越大。

ALL_GLUE_DATABASES 视图

已授权数据目录身份证明访问的 AWS Glue 数据目录数据库。

数据类型 说明
DCAT_CON_ID VARCHAR2(4000) 数据目录连接 ID 的唯一标识符。
CATALOG_ID VARCHAR2(255) 数据目录唯一标识符。
NAME VARCHAR2(255) 数据库的名称。
DESCRIPTION VARCHAR2(2048) 资料库的说明。
LOCATION_URI VARCHAR2(1024) 此数据库的位置。
CREATE_TIME TIMESTAMP 在数据目录中创建数据库的时间。
PARAMETERS CLOB 包含键 - 值对的 JSON 文档,用于定义数据库的参数和属性。
TARGET_DATABASE VARCHAR2(4000) 描述用于在 AWS 中链接资源的目标数据库的 JSON 文档。

ALL_GLUE_TABLES 视图

此视图显示数据目录身份证明有权访问的所有 AWS Glue 数据目录表。

数据类型 说明
DCAT_CON_ID VARCHAR2(4000) 数据目录连接 ID 的唯一标识符。
CATALOG_ID VARCHAR2(255) 目录标识
DATABASE_NAME VARCHAR2(255) 数据库名称
NAME VARCHAR2(255) 表名
TABLE_TYPE VARCHAR2(255) 表类型
CLASSIFICATION VARCHAR2(255)  
DESCRIPTION VARCHAR2(2048) 表说明
OWNER VARCHAR2(255) 表所有者
CREATED_BY VARCHAR2(255) 表创建者
CREATE_TIME TIMESTAMP 在数据目录中创建表的时间。
LAST_ANALYZED_TIME TIMESTAMP 上次为此表计算列统计信息的时间。
LAST_ACCESS_TIME TIMESTAMP 上次访问该表的时间。
UPDATE_TIME TIMESTAMP 上次更新表的时间。
IS_REGISTERED_WITH_LAKE_FORMATION NUMBER 指示表是否已在 AWS 数据湖形成中注册。
PARAMETERS CLOB 包含用于定义表属性的键 - 值对的 JSON 文档。
PARTITION_KEYS CLOB 包含表分区所依据的列列表的 JSON 文档。
RETENTION NUMBER 此表的保留时间。
STORAGE_DESCRIPTION CLOB 包含表物理存储信息的 JSON 文档。
TARGET_TABLE VARCHAR2(4000) 描述在 AWS 中用于资源链接的目标表的 JSON 文档。
VERSION_ID VARCHAR2(255) 表的版本标识符。
VIEW_EXPANDED_TEXT CLOB AWS Glue 推出,旨在与 Hive 兼容。AWS Glue 未使用。
VIEW_ORIGINAL_TEXT CLOB AWS Glue 推出,旨在与 Hive 兼容。AWS Glue 未使用。

DCAT_ATTRIBUTES 视图

列出逻辑实体属性到外部表列的映射。

数据类型 说明
DCAT_CON_ID VARCHAR2 (4000) 在实例中唯一的连接标识符
ASSET_KEY VARCHAR2(4000) 数据目录 - 资产关键字
ENTITY_KEY VARCHAR2(4000) 数据目录实体关键字
ATTRIBUTE_KEY VARCHAR2(4000) 数据目录属性键
ORACLE_COLUMN_NAME VARCHAR2(128) 映射的列名

DCAT_ENTITIES 视图

描述逻辑实体到外部表的映射。

数据类型 说明
DCAT_CON_ID VARCHAR2(4000) 在实例中唯一的连接标识符
ASSET_KEY VARCHAR2(4000) 数据目录 - 资产关键字
ENTITY_KEY VARCHAR2(4000) 数据目录实体关键字
FOLDER_KEY VARCHAR2(4000) 数据目录文件夹键
ORACLE_TABLE_NAME VARCHAR2(128) 映射的表名称
ORACLE_SCHEMA_NAME VARCHAR2(128) 映射的方案名称
ENTITY_ORACLE_DB_SCHEMA VARCHAR2(4000) 用于派生方案的实体的 oracle-db-schema 定制属性
ASSET_ORACLE_DB_SCHEMA VARCHAR2(4000) 用于派生方案的数据资产的 oracle-db-schema 自定义属性
FOLDER_ORACLE_DB_SCHEMA VARCHAR2(4000) 用于派生方案的文件夹的 oracle-db-schema 定制属性

DBMS_DCAT$SYNC_LOG 视图

通过 DBMS_DCAT$SYNC_LOG 视图,可以轻松访问当前用户执行的最后一个同步操作的日志表。

RUN_SYNC 过程的每次调用都会记录到新的日志表中,该表由 USER_LOAD_OPERATIONSLOGFILE_TABLE 字段指向。日志表将在 2 天后自动删除,用户可以使用类型为 DCAT_SYNCDELETE_ALL_OPERATIONS 过程清除所有同步日志。

DBMS_DCAT$SYNC_LOG 视图自动标识最新的日志表。DBMS_DCAT$SYNC_LOG 视图的方案如下所述,访问权限与各个日志表的访问权限相同。缺省情况下,READ 授予 dbms_dcat 角色和 ADMIN 用户。

日志表的格式如下:

数据类型 说明
LOG_TIMESTAMP TIMESTAMP 日志条目的时间戳。
LOG_LEVEL VARCHAR2(32) 条目日志级别可以具有以下值之一:OFFFATALERRORWARNINFODEBUGTRACEALL
LOG_DETAILS VARCHAR2(32767) 日志消息。