MaxCompute:Tabel Objek

Sintaks

CREATE OBJECT TABLE [IF NOT EXISTS] <objecttable_name>
WITH SERDEPROPERTIES ('<key>' = '<value>')
LOCATION '<location>'
[TBLPROPERTIES ('<key>' = '<value>')]
[COMMENT '<comment>'];

Anda tidak perlu mendefinisikan kolom. MaxCompute menyediakan kolom metadata secara otomatis.

Parameter

Contoh

SET odps.namespace.schema=true;

CREATE OBJECT TABLE ot_demo_day
WITH SERDEPROPERTIES (
  'odps.properties.rolearn'='acs:ram::xxxxxx:role/aliyunodpsdefaultrole'
)
LOCATION 'oss://oss-cn-hangzhou-internal.aliyuncs.com/odps-external-****/ottest/';

Pilih mode refresh

Pilih mode refresh saat membuat tabel atau biarkan sebagai default (manual).

Refresh manual

Jalankan perintah berikut untuk memicu refresh metadata penuh:

ALTER TABLE <objecttable_name> REFRESH METADATA;

Contoh:

ALTER TABLE ot_demo_day REFRESH METADATA;

Refresh periodik

Atur metadata.cache.mode ke periodic dan tentukan metadata.staleness.seconds saat membuat tabel. Penjadwal akan memicu refresh penuh kira-kira sesuai interval yang Anda tentukan.

SET odps.namespace.schema=true;
SET odps.sql.type.system.odps2 = true;

CREATE OBJECT TABLE ot_demo_day
WITH SERDEPROPERTIES (
  'odps.properties.rolearn'='acs:ram::xxxxxx:role/aliyunodpsdefaultrole'
)
LOCATION 'oss://oss-cn-hangzhou-internal.aliyuncs.com/odps-external-****/ottest/'
TBLPROPERTIES (
  'metadata.cache.mode' = 'periodic',
  'metadata.staleness.seconds' = '3600'
);

metadata.staleness.seconds menerima nilai antara 1 dan 604800 (1 detik hingga 1 minggu). Nilai ini bukan jaminan ketat — penjadwal menggunakannya sebagai target.

Refresh terjadwal

Atur metadata.cache.mode ke crontab dan tentukan metadata.crontab.expression saat membuat tabel. Gunakan ekspresi cron standar untuk menentukan jadwal tepatnya.

SET odps.namespace.schema=true;
SET odps.sql.type.system.odps2 = true;

CREATE OBJECT TABLE ot_demo_day
WITH SERDEPROPERTIES (
  'odps.properties.rolearn'='acs:ram::xxxxxx:role/aliyunodpsdefaultrole'
)
LOCATION 'oss://oss-cn-region-internal.aliyuncs.com/odps-external-****/ottest/'
TBLPROPERTIES (
  'metadata.cache.mode' = 'crontab',
  'metadata.crontab.expression' = '0 0 14 * * ?'
);

Ekspresi cron 0 0 14 * * ? menjalankan refresh setiap hari pukul 14.00: 0 (detik), 0 (menit), 14 (jam), * (hari dalam bulan apa pun), * (bulan apa pun), ? (hari dalam minggu — saling eksklusif dengan hari dalam bulan).

Lihat riwayat tugas refresh

Periksa status tugas refresh sebelumnya dengan:

SHOW refresh task history FOR object TABLE <object_table_name>;

Contoh dan output:

-- View refresh task history for ot_demo_day04.
SHOW refresh task history FOR object TABLE ot_demo_day04;

ID = 20260105*******f
+---------------------------------------------------------------------------------------------------+
| Project:                  test_project                                                            |
| Schema:                   default                                                                 |
| Task:                     ***                                                                     |
+---------------------------------------------------------------------------------------------------+
| History:                                                                                          |
+---------------------------------------------------------------------------------------------------+
| InstanceId                       | CreateTime             | EndTime                | Status       |
+---------------------------------------------------------------------------------------------------+
| 20260105******************ks     | 2026-01-05 14:12:00    | 2026-01-05 14:12:04    | Terminated   |
| 20260105******************y3     | 2026-01-05 14:10:00    | 2026-01-05 14:10:03    | Terminated   |
+---------------------------------------------------------------------------------------------------+

OK

Output berisi satu baris per tugas: InstanceId, CreateTime, EndTime, dan Status. Jika suatu tugas menunjukkan Failed, jalankan wait <InstanceId>; dan periksa output Logview untuk detailnya.

GET_DATA_FROM_OSS

GET_DATA_FROM_OSS membaca sebagian atau seluruh objek dan mengembalikannya sebagai nilai biner. Semua contoh di bawah menggunakan path tiga tingkat project.schema.object_table untuk mengidentifikasi Tabel Objek.

BINARY GET_DATA_FROM_OSS (
  STRING <full_object_table_name>,
  STRING <key>
  [, BIGINT <offset>]
  [, BIGINT <length>]
  [, STRING <object_not_found_policy>]
)

GET_DATA_FROM_OSS mengembalikan data biner. Bungkus dengan STRING() untuk mendapatkan hasil string.

Contoh

Ubah hasil menjadi STRING:

SELECT STRING(
  GET_DATA_FROM_OSS('<project_name>.default.ot_demo_day', key, 0, -1, 'OUTPUT_NULL')
)
FROM ot_demo_day;

Panggilan ekuivalen — semua contoh berikut membaca konten penuh setiap objek dengan pengaturan default (offset=0, length=-1, policy=OUTPUT_NULL):

-- Full explicit form
SELECT GET_DATA_FROM_OSS('<project_name>.default.ot_demo_day', key, 0, -1, 'OUTPUT_NULL') FROM ot_demo_day;

-- Equivalent shorthand forms
SELECT GET_DATA_FROM_OSS('<project_name>.default.ot_demo_day', key) FROM ot_demo_day;

SELECT GET_DATA_FROM_OSS('<project_name>.default.ot_demo_day', key, 0) FROM ot_demo_day;

SELECT GET_DATA_FROM_OSS('<project_name>.default.ot_demo_day', key, 0, -1) FROM ot_demo_day;

SELECT GET_DATA_FROM_OSS('<project_name>.default.ot_demo_day', key, 'OUTPUT_NULL') FROM ot_demo_day;

SELECT GET_DATA_FROM_OSS('<project_name>.default.ot_demo_day', key, 0, 'OUTPUT_NULL') FROM ot_demo_day;

Hapus metadata Tabel Objek

TRUNCATE TABLE menghapus semua metadata yang di-cache tetapi mempertahankan definisi tabel:

TRUNCATE TABLE <object_table_name>;

Contoh:

TRUNCATE TABLE ot_demo_day;

Ubah nama Tabel Objek

ALTER TABLE <object_table_name> RENAME TO <new_object_table_name>;

Contoh:

ALTER TABLE ot_demo_day RENAME TO new_ot_demo_day;

Hapus Tabel Objek

Menghapus Tabel Objek menghapus metadata yang di-cache dan menghentikan biaya penyimpanan. Data OSS aktual tidak terpengaruh. Buat ulang tabel kapan saja untuk melanjutkan penggunaan data.

DROP TABLE [IF EXISTS] <object_table_name>;

Contoh:

DROP TABLE IF EXISTS ot_demo_day;

Error connection refused saat merefresh metadata

Anda melihat error seperti:

ODPS-0010000:System internal error -
ActionHandler job failed with failinfo storage service worker error occured:
common/io/oss/oss_file_system_cppsdk.cpp(919):
OSSRequestException: Status: -50, RequestId: ,
ErrorCode: ClientError:-50, Message: E_HTTP_ERROR_CONN_REFUSED

Parameter location diatur ke titik akhir OSS publik. Tabel Objek memerlukan titik akhir jaringan internal. Perbarui parameter location agar menggunakan titik akhir internal — lihat deskripsi parameter location di Buat Tabel Objek.

Refresh periodik tidak terpicu sesuai jadwal

Periksa bahwa parameter location menggunakan nama domain jaringan internal OSS, bukan titik akhir publik. Lihat deskripsi parameter location di Buat Tabel Objek.

Tugas refresh periodik gagal dengan error internal

Anda melihat:

FAILED: ODPS-0010000:System internal error - ActionHandler job failed with failinfo
storage service worker error occured: common/io/oss/oss_file_system_cppsdk.cpp(877):
OSSRequestException: Status: -50, RequestId: , ErrorCode: ClientError:-50, Message:

Ini adalah error sisi platform. Kirim tiket untuk menghubungi dukungan teknis MaxCompute.