All Products
Search

This Product

    :Gunakan data terbuka

    Document Center

    :Gunakan data terbuka

    Last Updated:Apr 05, 2026

    Setelah menginstal paket data terbuka DataWorks, Anda dapat menggunakan fitur data terbuka untuk memperoleh metadata, yang membantu menyiapkan data guna tata kelola dan O&M selanjutnya. Topik ini menjelaskan kasus penggunaan utama fitur data terbuka serta menyediakan perintah yang diperlukan.

    Penting

    DataWorks telah merilis fitur data terbuka versi baru yang memungkinkan penelusuran dan pengelolaan metadata melalui antarmuka pengguna visual. Kami merekomendasikan penggunaan versi resmi fitur ini. Untuk informasi lebih lanjut, lihat Gunakan fitur data terbuka.

    Prasyarat

    Paket data terbuka telah diinstal. Untuk informasi lebih lanjut, lihat Instal atau uninstal paket data terbuka (Versi undangan akan segera ditinggalkan).

    Penggunaan

    Topik ini menggunakan node ODPS SQL di DataWorks sebagai contoh untuk menjelaskan perintah guna memperoleh berbagai jenis metadata menggunakan fitur data terbuka. Sebelum menjalankan perintah, buka editor kode node ODPS SQL dengan langkah-langkah berikut:

    1. Buka halaman DataStudio.
      1. Masuk ke DataWorks console.
      2. Di panel navigasi kiri, klik Workspaces.
      3. Pada halaman Workspaces, temukan ruang kerja yang diinginkan lalu klik Data Analytics di kolom Actions.

    2. Buka editor kode node ODPS SQL.

      Di panel Business Flow, temukan Data Development di bawah mesin komputasi MaxCompute. Klik kanan Data Development lalu pilih Create > ODPS SQL untuk membuat node ODPS SQL.

    Anda dapat menggunakan fitur data terbuka untuk memperoleh berbagai jenis metadata:

    Menampilkan database yang telah dibuat (Proyek MaxCompute)

    Tampilan raw_v_meta_database dalam fitur data terbuka DataWorks digunakan untuk mengkueri database yang telah dibuat. Perintahnya adalah sebagai berikut.

    SELECT * FROM u_meta_hangzhou.raw_v_meta_database_<version>('<business_date>');

    Tabel berikut menjelaskan parameter tersebut.

    • Informasi versi: Versi fitur data terbuka yang digunakan. Formatnya mirip dengan v1_1. Anda dapat menjalankan perintah DESCRIBE PACKAGE untuk mengkueri versi aktual. Untuk informasi lebih lanjut, lihat Lihat tabel atau tampilan yang disediakan oleh fitur data terbuka DataWorks.

    • Tanggal bisnis: Tanggal bisnis untuk melihat metadata, dalam format yyyymmdd. Jika tanggal bisnis tidak ditentukan, metadata untuk semua tanggal akan ditampilkan.

    Kode berikut memberikan contoh:

    -- Kueri daftar database yang dibuat pada 9 Januari 2021.
SELECT * FROM u_meta_hangzhou.raw_v_meta_database_v1_1('20210109');

    Contoh hasil kueri: 使用结果1 Untuk informasi lebih lanjut tentang bidang-bidang dalam hasil kueri, lihat Metadata database (Proyek MaxCompute): raw_v_meta_database.

    Menampilkan tabel dalam suatu proyek

    Tampilan raw_v_meta_table dari fitur data terbuka DataWorks digunakan untuk mengkueri informasi tentang tabel dalam suatu proyek. Perintahnya adalah sebagai berikut.

    SELECT *
  FROM u_meta_hangzhou.raw_v_meta_table_<version>('<business_date>')
  WHERE catalog_name = 'your_catalog_name'
   AND database_name = 'your_database_name'
   AND table_name = 'your_table_name'
;

    Tabel berikut menjelaskan parameter tersebut.

    • Informasi versi: Versi fitur data terbuka yang digunakan. Formatnya mirip dengan v1_1. Anda dapat menjalankan perintah DESCRIBE PACKAGE untuk mengkueri versi aktual. Untuk informasi lebih lanjut, lihat Lihat tabel atau tampilan yang disediakan oleh fitur data terbuka DataWorks.

    • Tanggal bisnis: Tanggal bisnis untuk melihat metadata, dalam format yyyymmdd. Jika tanggal bisnis tidak ditentukan, metadata untuk semua tanggal akan ditampilkan.

    • your_catalog_name: Katalog untuk metadata mesin komputasi tertentu. Tetapkan parameter ini ke odps.

    • your_database_name: Nama proyek yang akan dikueri. Ganti dengan nama proyek aktual.

    • your_table_name: Nama tabel yang akan dikueri. Ganti dengan nama tabel aktual.

    Kode berikut memberikan contoh:

    -- Kueri tabel ods_user_info_d dalam proyek MaxCompute bernama isv2 pada 9 Januari 2021.
SELECT *
  FROM u_meta_hangzhou.raw_v_meta_table_v1_1('20210109')
  WHERE catalog_name = 'odps'
   AND database_name = 'isv2'
   AND table_name = 'ods_user_info_d'
;

    Contoh hasil kueri: 使用结果2 Untuk informasi lebih lanjut tentang bidang-bidang dalam hasil kueri, lihat Metadata tabel: raw_v_meta_table.

    Mengkueri statistik tabel

    Tampilan rpt_v_meta_ind_table_core dan rpt_v_meta_ind_table_extra dalam fitur data terbuka DataWorks dapat digunakan untuk mengkueri statistik tabel, seperti ID penyewa dan lifecycle tabel. Perintahnya adalah sebagai berikut.

    SELECT c.tenant_id, c.table_uuid, c.dim_life_cycle, c.is_partition_table, c.entity_type, c.categories, c.last_access_time, c.partition_count, c.favorite_count, e.output_task_count
FROM u_meta_hangzhou.rpt_v_meta_ind_table_core_<version>('<business_date>') c 
LEFT OUTER JOIN u_meta_hangzhou.rpt_v_meta_ind_table_extra_<version>('<business_date>') e 
ON c.table_uuid = e.table_uuid AND c.tenant_id = e.tenant_id 
WHERE c.catalog_name = 'your_catalog_name'
  AND c.database_name = 'your_database_name'
  AND c.table_name = 'your_table_name'
;

    Tabel berikut menjelaskan parameter tersebut.

    • Informasi versi: Versi fitur data terbuka yang digunakan. Formatnya mirip dengan v1_1. Anda dapat menjalankan perintah DESCRIBE PACKAGE untuk mengkueri versi aktual. Untuk informasi lebih lanjut, lihat Lihat tabel atau tampilan yang disediakan oleh fitur data terbuka DataWorks.

    • Tanggal bisnis: Tanggal bisnis untuk melihat metadata, dalam format yyyymmdd. Jika tanggal bisnis tidak ditentukan, metadata untuk semua tanggal akan ditampilkan.

    • your_catalog_name: Katalog untuk metadata mesin komputasi tertentu. Tetapkan parameter ini ke odps.

    • your_database_name: Nama proyek yang akan dikueri. Ganti dengan nama proyek aktual.

    • your_table_name: Nama tabel yang akan dikueri. Ganti dengan nama tabel aktual.

    Kode berikut memberikan contoh:

    -- Kueri informasi statistik tabel ods_user_info_d dalam proyek MaxCompute bernama isv2 pada 9 Januari 2021.
SELECT c.tenant_id, c.table_uuid, c.dim_life_cycle, c.is_partition_table, c.entity_type, c.categories, c.last_access_time, c.partition_count, c.favorite_count, e.output_task_count
FROM u_meta_hangzhou.rpt_v_meta_ind_table_core_v1_1('20210109') c 
LEFT OUTER JOIN u_meta_hangzhou.rpt_v_meta_ind_table_extra_v1_1('20210109') e 
ON c.table_uuid = e.table_uuid AND c.tenant_id = e.tenant_id 
WHERE c.catalog_name = 'odps'
  AND c.database_name = 'isv2'
  AND c.table_name = 'ods_user_info_d'
;

    Contoh hasil kueri: 结果 Untuk informasi lebih lanjut tentang bidang-bidang dalam hasil kueri, lihat Metrik inti tabel: rpt_v_meta_ind_table_core dan Metrik tambahan tabel: rpt_v_meta_ind_table_extra.

    Menampilkan detail node untuk tabel output

    Anda dapat menggunakan tampilan raw_v_meta_table_output dan raw_v_schedule_node dalam fitur data terbuka DataWorks untuk mengkueri detail node untuk suatu tabel. Perintahnya adalah sebagai berikut.

    SELECT s.*, o.schedule_instance_id, execute_time
  FROM u_meta_hangzhou.raw_v_meta_table_output_<version>('<business_date>') o 
  LEFT OUTER JOIN u_meta_hangzhou.raw_v_schedule_node_<version>('<business_date>') s 
  ON o.schedule_task_id = s.node_id
WHERE o.type = 'your_table_type'
  AND o.database = 'your_database_name'
  AND o.table = 'your_table_name'
  AND s.project_env = 'your_project_environment'
;

    Tabel berikut menjelaskan parameter tersebut.

    • Informasi versi: Versi fitur data terbuka yang digunakan. Formatnya mirip dengan v1_1. Anda dapat menjalankan perintah DESCRIBE PACKAGE untuk mengkueri versi aktual. Untuk informasi lebih lanjut, lihat Lihat tabel atau tampilan yang disediakan oleh fitur data terbuka DataWorks.

    • Tanggal bisnis: Tanggal bisnis untuk melihat metadata, dalam format yyyymmdd. Jika tanggal bisnis tidak ditentukan, metadata untuk semua tanggal akan ditampilkan.

    • your_table_type: Jenis tabel output yang akan diambil metadatanya. Parameter ini saat ini hanya didukung untuk MaxCompute. Tetapkan parameter ini ke odps.

    • your_database_name: Nama proyek yang akan dikueri. Ganti dengan nama proyek aktual.

    • your_table_name: Nama tabel yang akan dikueri. Ganti dengan nama tabel aktual.

    • your_project_environment: Menentukan lingkungan proyek yang metadatanya ingin Anda lihat. Tetapkan ke DEV untuk lingkungan pengembangan atau PROD untuk lingkungan produksi.

    Kode berikut memberikan contoh:

    -- Kueri detail node produksi untuk tabel odps bernama ods_user_info_d dalam proyek xc_simple_e1 pada 9 Januari 2021.
SELECT s.*, o.schedule_instance_id, execute_time
  FROM u_meta_hangzhou.raw_v_meta_table_output_v1_1('20210109') o 
  LEFT OUTER JOIN u_meta_hangzhou.raw_v_schedule_node_v1_1('20210109') s 
  ON o.schedule_task_id = s.node_id
WHERE o.type = 'odps'
  AND o.database = 'xc_simple_e1'
  AND o.table = 'ods_user_info_d'
  AND s.project_env = 'PROD'
;

    Contoh hasil kueri: 使用结果4 Untuk informasi lebih lanjut tentang bidang-bidang dalam hasil kueri, lihat Metadata node output tabel: raw_v_meta_table_output dan Detail node penjadwalan: raw_v_schedule_node.

    Menampilkan node leluhur dan node turunan

    Anda dapat menggunakan tampilan raw_v_schedule_node dan raw_v_schedule_node_relation dalam fitur data terbuka DataWorks untuk mengkueri node hulu dan hilir dari suatu node tertentu. Perintahnya adalah sebagai berikut.

    -- Kueri node leluhur.
SELECT * 
  FROM u_meta_hangzhou.raw_v_schedule_node_<version>('<business_date>') t
 WHERE t.project_env = 'your_project_environment'
   AND t.node_id IN (
     SELECT parent_node_id 
       FROM u_meta_hangzhou.raw_v_schedule_node_relation_<version>('<business_date>') r
      WHERE r.child_node_id = your_child_node_id
        AND r.project_env = 'your_project_environment'
 )
;
-- Kueri node turunan.
SELECT * 
  FROM u_meta_hangzhou.raw_v_schedule_node_<version>('<business_date>') t
 WHERE t.project_env = 'your_project_environment'
   AND t.node_id IN (
     SELECT child_node_id 
       FROM u_meta_hangzhou.raw_v_schedule_node_relation_<version>('<business_date>') r
      WHERE r.child_node_id = your_child_node_id
        AND r.project_env = 'your_project_environment'
 )
;

    Tabel berikut menjelaskan parameter tersebut.

    • Informasi versi: Versi fitur data terbuka yang digunakan. Formatnya mirip dengan v1_1. Anda dapat menjalankan perintah DESCRIBE PACKAGE untuk mengkueri versi aktual. Untuk informasi lebih lanjut, lihat Lihat tabel atau tampilan yang disediakan oleh fitur data terbuka DataWorks.

    • Tanggal bisnis: Tanggal bisnis untuk melihat metadata, dalam format yyyymmdd. Jika tanggal bisnis tidak ditentukan, metadata untuk semua tanggal akan ditampilkan.

    • your_project_environment: Menentukan lingkungan proyek yang metadatanya ingin Anda lihat. Tetapkan ke DEV untuk lingkungan pengembangan atau PROD untuk lingkungan produksi.

    • your_child_node_id: ID node yang akan dikueri.

    Kode berikut memberikan contoh:

    1. Kueri node leluhur dari suatu node tertentu di lingkungan produksi.

      -- Kueri daftar node leluhur untuk node 1000550985 di lingkungan produksi pada 9 Januari 2021.
SELECT * 
  FROM u_meta_hangzhou.raw_v_schedule_node_v1_1('20210109') t
 WHERE t.project_env = 'PROD'
   AND t.node_id IN (
     SELECT parent_node_id 
       FROM u_meta_hangzhou.raw_v_schedule_node_relation_v1_1('20210109') r
      WHERE r.child_node_id = 1000550985
        AND r.project_env = 'PROD'
 )
;

      Contoh hasil kueri: 5.1

    2. Kueri node turunan dari suatu node tertentu di lingkungan produksi.

      -- Kueri daftar node turunan untuk node 1000550985 di lingkungan produksi pada 9 Januari 2021.
SELECT * 
  FROM u_meta_hangzhou.raw_v_schedule_node_v1_1('20210109') t
 WHERE t.project_env = 'PROD'
   AND t.node_id IN (
     SELECT child_node_id
       FROM u_meta_hangzhou.raw_v_schedule_node_relation_v1_1('20210109') r
      WHERE r.parent_node_id = 1000550985
        AND r.project_env = 'PROD'
 )
;

      Contoh hasil kueri: 5.2

    Untuk informasi lebih lanjut tentang bidang-bidang dalam hasil kueri, lihat Detail node penjadwalan: raw_v_schedule_node dan Detail hubungan node penjadwalan: raw_v_schedule_node_relation.

    Menampilkan pemilik tabel dan node

    Anda dapat menggunakan tampilan raw_v_meta_table dan raw_v_tenant_user dalam fitur data terbuka DataWorks untuk mengkueri detail pemilik tabel atau node. Perintahnya adalah sebagai berikut.

    • Kueri detail pemilik tabel.

      SELECT
    c.catalog_name,
    c.database_name,
    c.table_name,
    c.owner_name,
    u.account_name,
    u.nick
FROM u_meta_hangzhou.raw_v_meta_table_<version>('<business_date>') c 
 LEFT OUTER JOIN u_meta_hangzhou.raw_v_tenant_user_<version>('<business_date>') u 
   ON c.owner_name = TOLOWER(u.yun_account)
 WHERE c.catalog_name = 'your_catalog_name'
   AND c.database_name = 'your_database_name'
   AND c.table_name = 'your_table_name'
;

      Tabel berikut menjelaskan parameter tersebut.

      • Informasi versi: Versi fitur data terbuka yang digunakan. Formatnya mirip dengan v1_1. Anda dapat menjalankan perintah DESCRIBE PACKAGE untuk mengkueri versi aktual. Untuk informasi lebih lanjut, lihat Lihat tabel atau tampilan yang disediakan oleh fitur data terbuka DataWorks.

      • Tanggal bisnis: Tanggal bisnis untuk melihat metadata, dalam format yyyymmdd. Jika tanggal bisnis tidak ditentukan, metadata untuk semua tanggal akan ditampilkan.

      • your_catalog_name: Katalog untuk metadata mesin komputasi tertentu. Tetapkan parameter ini ke odps.

      • your_database_name: Nama proyek yang akan dikueri. Ganti dengan nama proyek aktual.

      • your_table_name: Nama tabel yang akan dikueri. Ganti dengan nama tabel aktual.

    • Kueri detail pemilik node.

      SELECT t.project_id, t.node_id, t.node_name, 
    t.create_user, u.account_name AS create_user_name, u.nick as create_user_nick,
    t.modify_user, m.account_name AS modify_user_name, m.nick as modify_user_nick
  FROM u_meta_hangzhou.raw_v_schedule_node_<version>('<business_date>') t 
LEFT OUTER JOIN u_meta_hangzhou.raw_v_tenant_user_<version>('<business_date>') u ON t.create_user = u.yun_account
LEFT OUTER JOIN u_meta_hangzhou.raw_v_tenant_user_<version>('<business_date>') m ON t.modify_user = m.yun_account
 WHERE t.node_id = your_node_id
   AND t.project_env = 'your_project_environment'
;

      Tabel berikut menjelaskan parameter tersebut.

      • Informasi versi: Versi fitur data terbuka yang digunakan. Formatnya mirip dengan v1_1. Anda dapat menjalankan perintah DESCRIBE PACKAGE untuk mengkueri versi aktual. Untuk informasi lebih lanjut, lihat Lihat tabel atau tampilan yang disediakan oleh fitur data terbuka DataWorks.

      • Tanggal bisnis: Tanggal bisnis untuk melihat metadata, dalam format yyyymmdd. Jika tanggal bisnis tidak ditentukan, metadata untuk semua tanggal akan ditampilkan.

      • your_project_environment: Menentukan lingkungan proyek yang metadatanya ingin Anda lihat. Tetapkan ke DEV untuk lingkungan pengembangan atau PROD untuk lingkungan produksi.

      • your_node_id: ID node yang akan dikueri.

    Kode berikut memberikan contoh:

    1. Kueri detail pemilik tabel pada 9 Januari 2021.

      SELECT
    c.catalog_name,
    c.database_name,
    c.table_name,
    c.owner_name,
    u.account_name,
    u.nick
FROM u_meta_hangzhou.raw_v_meta_table_v1_1('20210109') c 
 LEFT OUTER JOIN u_meta_hangzhou.raw_v_tenant_user_v1_1('20210109') u 
   ON c.owner_name = TOLOWER(u.yun_account)
 WHERE c.catalog_name = 'odps'
   AND c.database_name = 'isv2'
   AND c.table_name = 'ods_user_info_d'
;

      Contoh hasil kueri: 6.1

    2. Kueri detail pembuat dan pengubah node terjadwal pada 9 Januari 2021.

      SELECT t.project_id, t.node_id, t.node_name, 
    t.create_user, u.account_name AS create_user_name, u.nick as create_user_nick,
    t.modify_user, m.account_name AS modify_user_name, m.nick as modify_user_nick
  FROM u_meta_hangzhou.raw_v_schedule_node_v1_1('20210109') t 
LEFT OUTER JOIN u_meta_hangzhou.raw_v_tenant_user_v1_1('20210109') u ON t.create_user = u.yun_account
LEFT OUTER JOIN u_meta_hangzhou.raw_v_tenant_user_v1_1('20210109') m ON t.modify_user = m.yun_account
 WHERE t.node_id = 1000454827
   AND t.project_env = 'PROD'
;

      Contoh hasil kueri: 6.2

    Untuk informasi lebih lanjut tentang bidang-bidang dalam hasil kueri, lihat Detail node penjadwalan: raw_v_schedule_node dan Detail hubungan node penjadwalan: raw_v_schedule_node_relation.

    Langkah selanjutnya

    Tampilan yang disediakan oleh fitur data terbuka menerima parameter tanggal dalam format yyyyMMdd. Anda dapat menggunakan parameter ini untuk mem-partisi data berdasarkan tanggal dan mengambil data historis dari 30 hari terakhir. Jika perlu melakukan analisis tren metrik, Anda dapat memperoleh data berdasarkan tanggal bisnis dan menyimpannya ke proyek Anda untuk analisis historis.