DBMS_DATAMART 패키지 참조

이 섹션에서는 Data Studio의 Data Marketplace 도구와 함께 사용되는 패키지에 대한 정보를 제공합니다. DBMS_DATAMART 항목에서는 DBMS_DATAMART 패키지에 포함된 프로시저도 다룹니다. DBMS_DATAMART 패키지는 데이터 마켓플레이스와의 공통 작업을 지원하는 API를 제공합니다.

항목:

DBMS_DATAMART 프로시저

DBMS_DATAMART 서브 프로그램 요약
Oracle Data Marketplace API를 사용하여 데이터 집합을 등록하고 액세스할 수 있습니다.

상위 항목: Data Marketplace 도구

DBMS_DATAMART 서브 프로그램 요약

Oracle Data Marketplace API를 사용하여 데이터세트를 등록하고 액세스할 수 있습니다.

DBMS_DATAMART 패키지 서브 프로그램

DBMS_DATAMART 패키지는 객체 등록, 액세스 요청, 액세스 권한 부여, 액세스 권한 취소, 데이터 집합 등록 해제 및 나열과 같은 Oracle Data Marketplace의 일반적인 작업을 간소화합니다.

다음 표에서는 DBMS_DATAMART 하위 프로그램을 나열하고 간략하게 설명합니다.

하위 프로그램	설명
등록-객체	이 절차에서는 데이터 세트를 등록합니다.
request_access	이 절차에서는 특정 데이터 세트에 대한 액세스를 요청합니다.
grant_access	이 절차에서는 특정 데이터 세트에 대한 액세스 권한을 부여합니다.
취소_액세스	이 절차에서는 특정 데이터 세트에 대한 액세스를 취소합니다.
등록 해제	이 절차에서는 데이터 세트의 등록을 해제합니다.
list_data_set	이 절차에서는 데이터 세트 목록을 반환합니다.
재고 이미지 URL 가져오기	이 프로시저는 이미지를 선택할 수 있는 URL 기준을 반환합니다.
get_reserved_namespaces	이 프로시저는 시스템에서 예약되어 있으며 사용자가 사용할 수 없는 네임스페이스의 JSON 배열을 표시합니다.
갱신_등록	이 절차에서는 기존 등록을 업데이트합니다.

객체 등록 프로시저

이 절차에서는 데이터 세트를 등록합니다.

구문

procedure register_object(schema_name         in varchar2,
                          object_name         in varchar2,
                          namespace           in varchar2,
                          data_set_name       in varchar2,
                          scope               in clob default null,
                          thumbnail           in blob default null,
                          thumbnail_url       in varchar2 default null,
                          thumbnail_mime_type in varchar2 default null,
                          parameters          in clob default null);

객체 매개변수 등록

Register Object 프로시저에 액세스하는 경우 다음 매개변수를 사용합니다.

매개변수	설명
`schema_name`	스키마의 이름입니다.
`object_name`	객체 이름입니다.
`namespace`	객체의 네임스페이스입니다.
`data_set_name`	데이터 세트의 이름입니다.
`scope`	이 매개변수는 데이터에 원격으로 액세스할 수 있는 사용자를 나타냅니다. 범위는 데이터베이스가 상주하는 지역, 개별 테넌시 또는 구획을 포함하여 다양한 레벨로 설정할 수 있습니다. `MY$REGION`는 지원되지 않습니다.
`thumbnail`	도구가 데이터 세트 덮개에 표시하는 이미지입니다. 이 매개변수는 사용할 수 없습니다.
`thumbnail_url`	고유한 `thumbnail_url`을 지정할 수 없습니다. Oracle은 이 매개변수를 제공합니다.
`thumbnail_mime_type`	MIME(Multipurpose Internet Mail Extensions) 유형의 축소판을 지정합니다.
`Parameters`	`tags`, `description`, `data_set_owner`, `authorization_required`, `offload_targets`, `offload_targets` 및 `store_sample`와 같은 JSON 매개변수를 지정합니다.

액세스 요청 프로시저

이 프로시저는 지정된 데이터 세트에 대한 액세스를 요청합니다.

구문

procedure request_access(namespace     in  varchar2,
                         data_set_name in  varchar2,
                         auth_info     out clob);

요청 액세스 매개변수

Request Access 프로시저에 액세스하는 경우 다음 매개변수를 사용합니다.

매개변수	설명
`Namespace`	객체의 네임스페이스입니다.
`Dataset name`	데이터 세트의 이름입니다.
`Auth Info`	이 매개변수는 반환 시 JSON으로 채워집니다. 데이터 집합 제공자가 전자메일 주소를 제공하고 요청 사용자가 Data Studio SMTP 설정을 설정한 경우 요청이 전자메일을 통해 제출되고 이 매개변수는 SMTP로 설정된 `delivery` 필드와 함께 생성됩니다. 그렇지 않으면 `delivery` 필드가 `browser`로 설정되며 나머지 메타데이터를 사용하여 전자메일을 통해 자체 요청을 제출해야 합니다.

액세스 권한 부여 프로시저

이 절차에서는 지정된 데이터 세트에 대한 액세스 권한을 부여합니다. 인증 정보 매개변수에는 공유 ID가 포함되어야 합니다.

구문

procedure grant_access(namespace     in varchar2,
                       data_set_name in varchar2,
                       auth_info     in clob);

액세스 취소 프로시저

이 절차에서는 지정된 데이터 세트에 대한 액세스를 취소합니다. 인증 정보 매개변수에는 공유 ID가 포함되어야 합니다.

구문

procedure revoke_access(namespace     in varchar2,
                        data_set_name in varchar2,
                        auth_info     in clob);

프로시저 등록 해제

이 절차에서는 지정된 데이터 세트에 대한 액세스를 취소합니다. 인증 정보 매개변수에는 공유 ID가 포함되어야 합니다.

구문

procedure unregister(namespace     in varchar2,
                     data_set_name in varchar2);

데이터 세트 목록 프로시저

이 절차에서는 데이터 세트 목록을 표시합니다.

구문

function list_data_sets(registrations in boolean default false)
  return clob;

registrations가 true인 경우 등록한 데이터 세트 목록이 반환됩니다. false인 경우 사용 가능한 데이터 세트를 반환합니다.

스톡 이미지 URL 가져오기 프로시저

이 절차에서는 이미지를 선택할 수 있는 URL을 표시합니다.

구문

function get_stock_image_url return varchar2;

예약된 네임스페이스 가져오기 프로시저

이 프로시저는 시스템에서 예약한 네임스페이스의 JSON 배열을 표시합니다. 이러한 네임스페이스는 사용할 수 없습니다.

구문

function get_reserved_namespaces return clob;

등록 절차 갱신

이 절차에서는 기존 등록을 업데이트합니다.

구문

procedure update_registration(namespace           in varchar2,
                              data_set_name       in varchar,
                              scope               in clob default null,
                              thumbnail           in blob default null,
                              thumbnail_url       in varchar2 default null,
                              thumbnail_mime_type in varchar2 default null,
                              parameters          in clob default null);

이 프로시저의 파라미터는 이미 위에 설명되어 있습니다.

상위 항목: DBMS_DATAMART 패키지 참조