Data Management：Akses instans database melalui HTTPS

Prasyarat

• Fitur proxy akses aman telah diaktifkan untuk instans database.

  Catatan

  Untuk memeriksa apakah fitur proxy akses aman telah diaktifkan untuk sebuah instans database, ikuti langkah-langkah berikut: Masuk ke konsol Data Management (DMS). Di bilah navigasi atas, pilih Security and Specifications > Secure Access Proxy > Proxy List. Pada tab Dibuat di halaman Daftar Proxy, instans dengan fitur proxy akses aman yang diaktifkan akan ditampilkan. Untuk informasi lebih lanjut tentang cara mengaktifkan fitur ini, lihat Aktifkan fitur proxy akses aman.

• Anda memiliki otorisasi untuk mengakses instans database menggunakan titik akhir proxy.

  Catatan

  Di halaman Detail instans database, periksa apakah Anda adalah pengguna yang berwenang dari instans tersebut. Jika tidak, ajukan permintaan izin untuk menggunakan titik akhir proxy guna mengakses instans database. Untuk informasi lebih lanjut, lihat Ajukan izin untuk mengakses instans database menggunakan titik akhir proxy.

Catatan Penggunaan

Jika instans database dikelola dalam mode Kolaborasi Keamanan, maka instans tersebut dipengaruhi oleh aturan keamanan. Maksimal 100.000 baris dapat dikembalikan untuk setiap query.

Parameter Permintaan

Parameter Respons

Jika Anda mengakses instans melalui HTTPS, data dikembalikan dalam format JSON.

Tabel berikut menjelaskan parameter respons dalam format JSON.

Contoh respons:

• Query data berhasil

  {
    "columnMetas": [
      {
        "columnName":"kolom1",
        "columnLabel":"kolom1",
        "columnTypeName":"varchar",
        "precision":10,
        "scale":2,
        "nullable":true,
        "autoIncrement":true,
        "tableName":"tabel1"
      },
      {
        "columnName":"kolom2",
        "columnLabel":"kolom2",
        "columnTypeName":"varchar",
        "precision":10,
        "scale":2,
        "nullable":true,
        "autoIncrement":true,
        "tableName":"tabel1"
      } 
    ],
    "updateCount": 0,
    "requestId": "xhqej0xgcytbhc8scjopgqsywcaibi",
    "rowCount": 1,
    "rows": [
      {
        "col1": 1,
        "col2": "xxxx"
      }
    ],
    "success": true
  }

• Pembaruan data berhasil

  {
    "updateCount": 0,
    "requestId": "xhqej0xgcytbhc8scjopgqsywcaibi",
    "success": true
  }

• Kegagalan akses

  {
    "message": 'AccessID diperlukan.',
    "requestId": "xhqej0xgcytbhc8scjopgqsywcaibi",
    "success": false
  }

Contoh mengakses instans database yang memiliki fitur proxy akses aman diaktifkan

Anda dapat menggunakan perintah, klien SQL, atau kode program untuk mengakses instans database yang memiliki fitur proxy akses aman diaktifkan.

Sebagai contoh, nama domain instans adalah dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com, nama database yang akan diakses adalah database, ID AccessKey adalah user, Rahasia AccessKey adalah pwd, dan pernyataan SQL yang akan dieksekusi adalah SHOW DATABASES.

• Gunakan perintah curl

  # Sintaks permintaan GET
  curl 'https://[Nama domain instans]/server/[Nama database]?accessId=[ID AccessKey]&accessSecret=[Rahasia AccessKey]&sql=[Pernyataan SQL]'

  # Contoh permintaan GET
  curl 'https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/database?accessId=user&accessSecret=pwd&sql=SHOW%20DATABASES'

  # Sintaks permintaan POST
  curl 'https://[Nama domain instans]/server/[Nama database]' -H 'accessId:[ID AccessKey]' -H 'accessSecret:[Rahasia AccessKey] -H 'Content-Type:text/plain' -d '[Pernyataan SQL]'

  # Contoh permintaan POST
  curl 'https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/database' -H 'accessId:user' -H 'accessSecret:pwd -H 'Content-Type:text/plain' -d 'SHOW DATABASES'

• Gunakan program Python 2

  Catatan

  Dalam contoh ini, program Python 2 digunakan untuk mengakses instans database.

  Sintaks permintaan GET

  import requests
  
  url = "https://[Nama domain instans]/server/[Nama database]?accessId=[ID AccessKey]&accessSecret=[Rahasia AccessKey]&sql=[Pernyataan SQL]"
  print requests.get(url).text

  Contoh permintaan GET

  import requests
  
  url = "https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/database?accessId=user&accessSecret=pwd&sql=SHOW DATABASES"
  print requests.get(url).text

  Sintaks permintaan POST

  import requests
  
  url = "https://[Nama domain instans]/server/[Nama database]"
  headers = {
      "Content-Type": "text/plain;charset=utf-8",
      "accessId": "[ID AccessKey]",
      "accessSecret": "[Rahasia AccessKey]"
  }
  print requests.post(url, headers=headers, data='[Pernyataan SQL]').text

  Contoh permintaan POST

  import requests
  
  url = "https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/database"
  headers = {
      "Content-Type": "text/plain;charset=utf-8",
      "accessId": "user",
      "accessSecret": "pwd"
  }
  print requests.post(url, headers=headers, data='SHOW DATABASES').text

• Gunakan program Node.js

  Sintaks permintaan GET

  const https = require("https");
  
  https.get("https://[Nama domain instans]/server/[nama database]?accessId=[ID AccessKey]&accessSecret=[Rahasia AccessKey]&sql=SHOW DATABASES", resp => {
      resp.on("data", data => {
          console.log(JSON.parse(data));
      });
  });

  Contoh permintaan GET

  const https = require("https");
  
  https.get("https://dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com/server/database?accessId=user&accessSecret=pwd&sql=SHOW DATABASES", resp => {
      resp.on("data", data => {
          console.log(JSON.parse(data));
      });
  });

  Sintaks permintaan POST

  const https = require("https");
  
  var req = https.request({
      hostname: '[Nama domain instans]',
      port: 443,
      path: '/server/[Nama database]',
      method: 'POST',
      headers: {
          'Content-Type': 'text/plain; charset=UTF-8',
          accessId: '[ID AccessKey]',
          accessSecret: '[Rahasia AccessKey]'
      }
  }, resp => {
      resp.on("data", data => {
          console.log(JSON.parse(data));
      });
  });
  req.write("[Pernyataan SQL]");
  req.end();

  Contoh permintaan POST

  const https = require("https");
  
  var req = https.request({
      hostname: 'dpxxxx-xxxxxxxx.proxy.dms.aliyuncs.com',
      port: 443,
      path: '/server/database',
      method: 'POST',
      headers: {
          'Content-Type': 'text/plain; charset=UTF-8',
          accessId: 'user',
          accessSecret: 'pwd'
      }
  }, resp => {
      resp.on("data", data => {
          console.log(JSON.parse(data));
      });
  });
  req.write("SHOW DATABASES");
  req.end();

• Gunakan klien Postman

  Sintaks permintaan GET

  Sintaks permintaan POST