全部产品
Search
文档中心

DataV:Tambahkan sumber data Tablestore

更新时间:Jul 06, 2025

Topik ini menjelaskan cara menambahkan sumber data Tablestore di DataV, serta parameter terkait.

Prasyarat

Sumber data Tablestore yang ingin ditambahkan sudah tersedia.

Tambahkan sumber data Tablestore

  1. Masuk ke Konsol DataV.

  2. Pada tab My Data, klik Data Source lalu Add Data.

  3. Pilih TableStore dari daftar drop-down Type.

  4. Masukkan informasi tentang sumber data Tablestore.

    Add Data Source

    Parameter

    Deskripsi

    Name

    Nama sumber data yang ingin Anda tambahkan. Anda dapat mengatur parameter ini ke nama kustom.

    AK ID

    ID AccessKey dari akun yang memiliki izin untuk mengakses sumber data Tablestore.

    AK Secret

    Rahasia AccessKey dari akun yang memiliki izin untuk mengakses sumber data Tablestore.

    Internet

    Titik akhir sumber data Tablestore yang ingin Anda tambahkan. Untuk informasi lebih lanjut, lihat Titik Akhir.

  5. Setelah memasukkan informasi sumber data Tablestore, klik OK.

    Sumber data yang telah ditambahkan akan muncul dalam daftar sumber data.

Gunakan sumber data Tablestore

  1. Masuk ke Konsol DataV.

  2. Pada tab Projects, arahkan kursor ke proyek yang ingin diedit dan klik Edit.

    Penting

    Jika belum membuat aplikasi visualisasi pada halaman My Visualizations, lihat Buat, Pratinjau, dan Publikasikan Aplikasi Visualisasi untuk membuat aplikasi visualisasi.

  3. Di Editor Canvas, klik widget di kanvas.

    Jika belum ada widget di kanvas, tambahkan widget terlebih dahulu. Untuk informasi lebih lanjut, lihat Manajemen Aset (Enterprise Edition).

  4. Di panel konfigurasi di sebelah kanan, klik tab Data lalu Set.

    Configure data sources

  5. Di panel Configure Data Source, pilih TableStore dari daftar drop-down Data Source Type.

  6. Di bagian Select Data Source, pilih sumber data Tablestore yang telah dikonfigurasi.

  7. Di bagian Select Action, pilih operasi yang ingin dilakukan.

    Sistem mendukung operasi berikut:

    • getRow: Menunjukkan operasi GetRow Tablestore. Untuk informasi lebih lanjut, lihat GetRow.

    • getRange: Menunjukkan operasi GetRange Tablestore. Untuk informasi lebih lanjut, lihat GetRange.

  8. Di editor kode bagian Select Action, masukkan pernyataan kueri.

    • Parameter kueri harus berupa objek JSON.

    • Jika memilih operasi getRow, satu baris data dibaca berdasarkan kunci utama yang ditentukan.

      Format parameter adalah sebagai berikut:

      {
          "table_name": "test",
          "rows": {
              "id": "1"
          },
          "columns": [
              "id",
              "test"
          ]
      }

      Bagian

      Fitur

      table_name

      Nama tabel Tablestore yang ingin Anda kueri.

      rows

      Kunci utama dari baris tersebut.

      Penting

      Jumlah dan tipe data kolom kunci utama yang ditentukan untuk setiap baris harus sama dengan jumlah dan tipe data kolom kunci utama di tabel.

      columns

      Nama kolom yang ingin Anda kembalikan.

    • Jika memilih operasi getRange, satu baris data dibaca berdasarkan kunci utama yang ditentukan. Format parameter adalah sebagai berikut:

      {
          "table_name": "test",
          "direction": "FORWARD",
          "columns": [
              "id",
              "test"
          ],
          "range": {
              "limit": 4,
              "start": {
                  "id": "InfMin"
              },
              "end": {
                  "id": "3"
              }
          }
      }

      Bagian

      Fitur

      table_name

      Nama tabel Tablestore yang ingin Anda kueri.

      direction

      Arah pembacaan.

      • Jika Anda mengatur parameter ini ke FORWARD, nilai inclusive_start_primary_key harus lebih kecil dari nilai exclusive_end_primary_key, dan baris dalam respons diurutkan dalam urutan naik berdasarkan nilai kunci utama.

      • Jika Anda mengatur parameter ini ke BACKWARD, nilai inclusive_start_primary_key harus lebih besar dari nilai exclusive_end_primary_key, dan baris dalam respons diurutkan dalam urutan turun berdasarkan nilai kunci utama.

      Sebagai contoh, jika Anda mengatur parameter direction ke FORWARD untuk tabel yang berisi dua kunci utama A dan B, dan nilai A lebih kecil dari nilai B, baris yang nilai kunci utamanya lebih besar dari atau sama dengan nilai A tetapi lebih kecil dari nilai B dikembalikan dalam urutan naik dari A ke B. Jika Anda mengatur parameter direction ke BACKWARD, baris yang nilai kunci utamanya lebih kecil dari atau sama dengan nilai B dan lebih besar dari nilai A dikembalikan dalam urutan turun dari B ke A.

      columns

      Kolom yang ingin Anda kembalikan. Anda dapat menentukan nama kolom kunci utama atau kolom atribut.

      Jika Anda tidak menentukan nama kolom, semua data dalam baris dikembalikan.

      Jika baris berada dalam rentang yang ditentukan berdasarkan nilai kunci utama tetapi tidak berisi kolom tertentu yang ingin Anda kembalikan, respons tidak menyertakan baris tersebut.

      limit

      Jumlah maksimum baris yang akan dikembalikan. Nilai parameter ini harus lebih besar dari 0.

      Operasi berhenti setelah jumlah maksimum baris yang dapat dikembalikan dalam arah maju atau mundur tercapai, meskipun beberapa baris dalam rentang yang ditentukan tidak dikembalikan.

      start

      Kunci utama awal dan akhir dari rentang yang akan dibaca. Kunci utama awal dan akhir harus berupa kunci utama valid atau titik virtual yang terdiri dari data tipe InfMin dan InfMax. Jumlah kolom untuk setiap titik virtual harus sama dengan jumlah kolom kunci utama.

      InfMin menunjukkan nilai yang sangat kecil. Semua nilai tipe lainnya lebih besar dari InfMin. InfMax menunjukkan nilai yang sangat besar. Semua nilai tipe lainnya lebih kecil dari InfMax.

      Penting

      Jumlah dan tipe data kolom kunci utama yang ditentukan untuk setiap baris harus sama dengan jumlah dan tipe data kolom kunci utama di tabel.

      • start menunjukkan kunci utama awal. Jika baris yang berisi kunci utama awal ada, baris data tersebut dikembalikan.

      • end menunjukkan kunci utama akhir. Terlepas dari apakah baris yang berisi kunci utama akhir ada, baris data tersebut tidak dikembalikan.

      end

  9. Klik Preview Data Response untuk melihat data yang dikembalikan.

Contoh permintaan

  1. Siapkan data Tablestore.

    1. Masuk ke Konsol Tablestore.

    2. Buat instance dan tabel di Konsol Tablestore. Untuk informasi lebih lanjut, lihat Buat Instance dan Buat Tabel.

      Instance test telah dibuat. Sebuah tabel dibuat untuk instance ini dengan tiga baris data dan dua kolom: id(Kunci Utama) dan test. Kolom id(Kunci Utama) bertipe INTEGER, sedangkan kolom test bertipe STRING. Gambar berikut menunjukkan detail tabel. Tablestore data

  2. Konfigurasikan sumber data.

    Configure data sources

  3. Parameter kueri.

    • Kueri data menggunakan getRow. Query data by using getRow

      Hasil berikut dikembalikan. Query results

    • Kueri data menggunakan getRange. Query data by using getRange

      Hasil berikut dikembalikan. Query results

    Catatan

    Jika mengkueri data menggunakan getRange, start adalah id: InfMin, dan end adalah id: 3. Oleh karena itu, data baris dengan id 1 dan baris dengan id 2 diperoleh. Hal ini karena getRange tidak mencakup baris end maupun baris dengan id 3.