Konfigurasikan DMS MCP untuk akses NL2SQL & DAO berbasis AI - Manajemen Data - Alibaba Cloud - Data Management

Model Context Protocol (MCP) menetapkan saluran komunikasi antara large language models (LLMs) dan tool eksternal. Topik ini menjelaskan cara mengonfigurasi Data Management (DMS) MCP untuk mengakses database yang dihosting di DMS secara aman menggunakan MCP Server yang kompatibel dengan multi-cloud.

Informasi latar belakang

Implementasi MCP database tradisional memiliki keterbatasan berikut:

Kompatibilitas terbatas dengan database heterogen: Implementasi tradisional hanya mendukung koneksi ke dan operasi pada database jenis yang sama, sehingga tidak memungkinkan manajemen lintas platform secara terpadu.
Tidak ada manajemen akun dan izin terpusat: Sistem tersebut tidak memiliki kemampuan untuk mengelola kredensial secara independen dan bergantung pada pemeliharaan manual, yang menimbulkan risiko keamanan.
Operasi SQL terbatas: Hanya mendukung pernyataan SQL dasar dan standar yang dimasukkan secara manual serta tidak dapat mengurai sintaksis kompleks atau non-standar.
Tidak ada dukungan NL2SQL bawaan: Tidak mendukung kueri natural language to SQL (NL2SQL) dan memerlukan integrasi dengan LLM eksternal untuk menggunakan fitur ini.

DMS MCP mengatasi masalah tersebut dengan menyediakan kemampuan ingesti dan akses data terpadu bagi LLM melalui antarmuka standar yang menyelesaikan tantangan kompatibilitas dan keamanan. Selain itu, DMS MCP membuka fitur-fitur baru, seperti mengambil informasi skema, menghasilkan kode Data Access Object (DAO), melakukan analisis struktural, dan menggunakan routing SQL otomatis untuk mengambil data secara akurat bagi aplikasi lapisan atas.

Fitur utama DMS MCP

Akses aman
- Penyimpanan kredensial aman: DMS mengelola username dan password database secara aman, menghilangkan kebutuhan penanganan manual dan mencegah kebocoran informasi sensitif.
- Akses jaringan pribadi: Anda dapat mengakses database melalui jaringan pribadi tanpa mengekspos titik akhir publik, sehingga menjamin keamanan dan privasi data.
- Kontrol akses detail halus: Anda dapat memberlakukan izin yang tepat pada level instans, database, tabel, kolom, dan baris untuk mencegah operasi tidak sah dan melindungi data.
- Deteksi dan pemblokiran pernyataan SQL berisiko tinggi: Aturan keamanan bawaan mengidentifikasi dan memblokir pernyataan SQL yang berpotensi berbahaya secara real time untuk mengurangi risiko keamanan.
- Audit dan ketertelusuran SQL: Semua operasi SQL dicatat untuk ketertelusuran penuh dan audit kepatuhan guna memenuhi persyaratan regulasi.
Kueri cerdas
- Algoritma NL2SQL bawaan: Fitur ini mengonversi pertanyaan dalam bahasa alami menjadi kueri SQL dengan mencocokkan tabel yang relevan secara cerdas dan memahami konteks bisnisnya, lalu mengeksekusi kueri tersebut untuk mengembalikan hasil dengan cepat.
- Basis pengetahuan yang dapat dikustomisasi: Fitur ini mencakup metadata bawaan dan basis pengetahuan kueri. Anda dapat mengkustomisasi pengetahuan bisnis dan pola kueri untuk membangun kemampuan kueri cerdas yang disesuaikan dengan skenario spesifik Anda.
Dukungan untuk berbagai sumber data
- Manajemen terpadu berbagai sumber data: DMS MCP mendukung lebih dari 40 database dan gudang data utama, memungkinkan akses terpadu ke berbagai jenis data.
- Manajemen multi-lingkungan terpusat: Anda dapat mengelola sumber data di lingkungan pengembangan, pengujian, dan produksi dari satu antarmuka, sehingga meningkatkan efisiensi operasi dan maintenance (O&M).
- Terintegrasi mulus dengan platform cloud utama, seperti Alibaba Cloud dan AWS, serta database dan gudang data yang dikelola sendiri untuk secara efektif mengurangi biaya pemeliharaan.

Diagram alur kerja

Diagram berikut menunjukkan alur kerja akses data saat client mengirim permintaan.

Skenario

Skenario 1: Hasilkan kode DAO (Data Access Object) dengan IDE AI seperti Tongyi Lingma

Berikut ini membandingkan alur kerja pengembangan tradisional dengan pengembangan cerdas menggunakan DMS MCP.

Alur kerja tradisional: Anda menjalankan pernyataan SQL pembuatan tabel secara manual menggunakan tool database, menulis kode DAO di integrated development environment (IDE), membangun data menggunakan tool database, lalu melihat pratinjau data tersebut.
Alur kerja pengembangan cerdas: Anda merancang tabel di IDE AI, membiarkan DMS MCP secara otomatis mengeksekusi pernyataan SQL pembuatan tabel, menghasilkan kode DAO secara otomatis di IDE, menggunakan MCP untuk membangun data secara cerdas, lalu melihat pratinjau hasilnya.

Skenario 2: Gunakan DMS NL2SQL untuk langsung mendapatkan statistik data

Analis pemasaran dapat menggunakan DMS NL2SQL untuk mengambil hasil statistik menggunakan bahasa alami, sehingga mempermudah analisis tren data.

Harga

DMS MCP saat ini dalam masa pratinjau publik dan tersedia tanpa biaya.

Jika Anda memerlukan informasi lebih lanjut tentang solusi ini, isi formulir untuk memberikan detail kontak Anda atau bergabung dengan grup DingTalk (ID: 129600002740) untuk menghubungi dukungan teknis DMS.

Persiapan

Sebelum Anda dapat menggunakan DMS MCP untuk mengakses database yang dihosting di DMS, Anda harus mendaftarkan instans database Anda di DMS dan mengaktifkan security hosting untuk setiap instans. Anda dapat menggunakan salah satu metode berikut untuk mendaftarkan instans:

Metode 1: Daftarkan instans database Alibaba Cloud menggunakan tool DMS MCP

Catatan

Metode ini hanya mendukung instans database Alibaba Cloud.
Instans yang didaftarkan menggunakan tool ini secara otomatis memiliki security hosting yang diaktifkan secara default.

DMS MCP Server menyediakan tool addInstance untuk membantu Anda mendaftarkan instans di DMS dengan cepat. Di agent terintegrasi MCP Anda, yaitu aplikasi AI percakapan, Anda dapat menginstruksikan LLM untuk mendaftarkan instans dengan memberikan detailnya, seperti ID instans, username database, password, dan wilayah. LLM kemudian secara otomatis memanggil tool yang sesuai.

Metode 2: Daftarkan instans database Alibaba Cloud, cloud lain, atau database yang dikelola sendiri melalui konsol DMS

Catatan

Metode ini mendukung instans database Alibaba Cloud, instans database di cloud lain, dan instans database yang dikelola sendiri. Langkah-langkah berikut menggunakan database ApsaraDB RDS for MySQL Alibaba Cloud sebagai contoh.

Masuk ke DMS 5.0.
Di bagian Database Instances panel navigasi kiri, klik ikon Add Instance .

Catatan
Atau, pilih Data Assets > Instances dari bilah navigasi atas dan klik New di halaman Instances.

Di halaman Add Instance, masukkan informasi instans.

Kategori	Item konfigurasi	Deskripsi
Data source	-	Default adalah Alibaba Cloud - MySQL. Anda dapat mengubah tipe database.
Basic information	Database type	Pilih tipe instans database. Catatan Setelah memilih tipe database, DMS secara otomatis memperbarui item konfigurasi di halaman Basic Information.
	Instance region	Pilih wilayah tempat instans database berada.
	Other primary accounts	Bidang ini hanya muncul jika Anda memilih Cross Alibaba Cloud Account Instance. Pilih akun root yang memiliki instans database tersebut. Catatan Jika akun root tidak muncul dalam daftar, klik Add User untuk menambahkan akun root pembeli. Untuk detailnya, lihat Tambahkan pengguna.
	Registration method	Pilih cara mendaftarkan instans database. Opsi yang tersedia adalah Instance ID atau Connection string.
	Instance ID atau Connection string	Masukkan Instance ID atau Connection string. Catatan Connection string terdiri dari titik akhir pribadi dan port. Untuk RDS MySQL, formatnya adalah rm-XXXXXXX.mysql.rds.aliyuncs.com:3306.
	Security Hosting	Pastikan opsi ini tetap diaktifkan. Mengaktifkan security hosting mencegah eksposur langsung kredensial dan memungkinkan kontrol izin detail halus.
	Access method	Metode akses berikut tersedia: Username and password logon: Masukkan username dan password database yang sudah ada secara manual. KMS credential logon: Pilih kredensial RDS yang dibuat di KMS secara manual untuk akses database. Catatan Opsi ini hanya muncul saat mendaftarkan instans RDS.
	Value-added feature package	Pilih paket fitur sesuai kebutuhan. Security Collaboration atau Stable Change (pilih salah satu): Security Collaboration mencakup semua kemampuan Stable Change dan menambahkan fitur DevOps untuk menyesuaikan alur kerja pengembangan dan persetujuan. Stable Change menyediakan solusi untuk operasi database yang stabil, seperti perubahan tanpa lock dan review SQL. Catatan Jika Anda tidak memilih Security Collaboration atau Stable Change, instans akan menggunakan Flexible Management secara default. Sensitive Data Protection: Fitur ini mengontrol dan menyamarkan data sensitif. Aktifkan sesuai kebutuhan bisnis Anda. Untuk detailnya, lihat Aktifkan Sensitive Data Protection.
	Security rules	Bidang ini hanya muncul jika Anda memilih Security Collaboration. Anda dapat memilih aturan keamanan sistem-default atau aturan keamanan kustom untuk kontrol database detail halus.
	Classification and grading template	Bidang ini hanya muncul saat Sensitive Data Protection diaktifkan. Untuk detailnya, lihat Templat klasifikasi dan gradasi.
Advanced information	-	Anda dapat mempertahankan nilai default untuk parameter di bagian ini. Untuk detailnya, lihat Daftarkan instans ApsaraDB.

Setelah memasukkan informasi yang diperlukan, klik Test Connection di pojok kiri bawah.

Catatan
Jika pengujian koneksi gagal, tinjau kembali informasi instans yang Anda masukkan dan perbaiki kesalahan berdasarkan pesan error.
Setelah muncul pesan Connection successful, klik Submit.

Instans database berhasil didaftarkan di DMS.

Untuk informasi lebih lanjut tentang prosedur pendaftaran, lihat Daftarkan instans ApsaraDB dan Daftarkan instans database cloud lain atau yang dikelola sendiri.

Mode penggunaan

DMS MCP Server mendukung dua mode penggunaan.

Mode

Skenario yang berlaku

Mode 1: Mode multi-instans

Gunakan mode ini untuk mengelola dan mengakses beberapa instans database di berbagai lingkungan. Daftarkan semua instans di DMS dan kelola melalui DMS MCP Server.

Mode 2: Mode single-database

Gunakan mode ini saat mengakses satu database. Konfigurasikan parameter CONNECTION_STRING di server untuk menentukan database target. Saat layanan dimulai, DMS MCP Server akan langsung mengakses database yang ditentukan.

Format: CONNECTION_STRING = dbName@host:port.

Di konsol DMS, temukan database di daftar sebelah kiri, klik ganda namanya, lalu gunakan jendela SQL untuk dengan cepat mendapatkan nilai CONNECTION_STRING.

Setelah membuka jendela SQL, lihat nilainya di bilah info koneksi di bagian atas, misalnya: mysql@192.xxx:3306.

Memulai dengan cepat

Opsi 1: Jalankan menggunakan paket PyPI

Peroleh AccessKey atau token Security Token Service (STS) yang memiliki izin AliyunDMSFullAccess untuk Data Management (DMS).

Untuk informasi lebih lanjut tentang cara menambahkan izin, lihat Manajemen otorisasi.

Tambahkan konfigurasi berikut ke file konfigurasi client MCP Anda.

Mode multi-instans

{
  "mcpServers": {
  "dms-mcp-server": {
    "command": "uvx",
    "args": [
      "alibabacloud-dms-mcp-server@latest"
    ],
    "env": {
      "ALIBABA_CLOUD_ACCESS_KEY_ID": "access_id",
      "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "access_key",
      "ALIBABA_CLOUD_SECURITY_TOKEN": "sts_security_token optional, required when using STS Token" 
      }
    }
  }
}

Single Database Mode

{
  "mcpServers": {
    "dms-mcp-server": {
      "command": "uvx",
      "args": [
        "alibabacloud-dms-mcp-server@latest"
      ],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "access_id",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "access_key",
        "ALIBABA_CLOUD_SECURITY_TOKEN": "optional sts_security_token, required when using STS Token",
        "CONNECTION_STRING": "dbName@host:port"
      }
    }
  }
}

Opsi 2: Gunakan layanan MCP yang dihosting di DMS

Masuk ke DMS 5.0.
Aktifkan layanan MCP.
1. Di pojok kanan bawah, arahkan pointer mouse ke ikon MCP dan klik Activate Now di kotak dialog yang muncul.
  
  Kotak dialog DMS MCP menampilkan empat fitur utama: Credential Security (penyimpanan kredensial bawaan), Secure Execution (akses jaringan pribadi dan izin detail halus), Unified Compatibility (dukungan untuk lebih dari 40 sumber data utama), dan Intelligent Querying (NL2SQL bawaan). Kotak dialog ini juga menyediakan tautan cepat ke dokumentasi produk dan video demonstrasi.
2. Pilih cakupan aktivasi untuk layanan MCP.
  - All databases: Semua instans database yang telah Anda daftarkan dengan mengikuti langkah-langkah di bagian Prasyarat.
  - Specific database: Salah satu instans database yang telah Anda daftarkan dengan mengikuti langkah-langkah di bagian Prasyarat.
    
    Catatan
    Jika Anda memilih Specific database, Anda juga harus memilih database target.
3. Klik Confirm Activation.
Setelah layanan diaktifkan, lihat informasi konfigurasi MCP.

Catatan
Arahkan pointer mouse ke ikon MCP di pojok kanan bawah untuk melihat konfigurasi MCP di kotak dialog yang muncul.
Integrasikan layanan DMS MCP ke dalam agent AI Anda dan mulai menggunakannya.
Catatan
- Saat menggunakan layanan DMS MCP, Anda harus mengatur Bearer Token di header Authorization berdasarkan nilai bidang Authorization dalam contoh MCP configuration example yang dijelaskan di Langkah 3.
- Untuk mengubah cakupan database MCP Server, Anda dapat membatalkan MCP Server terlebih dahulu. Untuk melakukannya, arahkan pointer mouse ke ikon MCP , klik Cancel Service, lalu klik Confirm Cancellation di kotak dialog yang muncul. Setelah layanan dibatalkan, Anda dapat mengaktifkan kembali MCP Server.

Opsi 3: Gunakan layanan DMS MCP yang dihosting di platform lain

Anda dapat menggunakan layanan DMS MCP di Alibaba Cloud Model Studio, ModelScope, dan Function AI.

Tool yang didukung oleh DMS MCP

Nama alat	Deskripsi	Mode yang didukung
`addInstance`	Mendaftarkan instans di DMS. Jika instans sudah ada, mengembalikan informasinya.	Mode multi-instans
`listInstances`	Mencari daftar instans di DMS.	Mode multi-instans
`getInstance`	Mendapatkan informasi detail instans berdasarkan host dan port.	Mode multi-instans
`searchDatabase`	Mencari database berdasarkan schemaName.	Mode multi-instans
`getDatabase`	Mendapatkan informasi detail untuk database tertentu.	Mode multi-instans
`listTable`	Mencari tabel di database tertentu.	Mode multi-instans & mode single-database
`getTableDetailInfo`	Mendapatkan informasi detail untuk tabel database tertentu.	Mode multi-instans & mode single-database
`executeScript`	Menjalankan skrip SQL dan mengembalikan hasilnya.	Mode multi-instans & mode single-database
`createDataChangeOrder`	Membuat tiket perubahan data untuk mengirim permintaan operasi DDL/DML.	Mode multi-instans & mode single-database
`getOrderInfo`	Menanyakan detail tiket, termasuk status, alur kerja persetujuan, dan log eksekusi.	Mode multi-instans & mode single-database
`submitOrderApproval`	Mengirimkan tiket ke alur kerja persetujuan untuk ditinjau sebelum dieksekusi.	Mode multi-instans & mode single-database
`generateSql`	Mengonversi pertanyaan bahasa alami menjadi pernyataan SQL yang dapat dieksekusi.	Mode multi-instans
`askDatabase`	Menanyakan database menggunakan bahasa alami (NL2SQL + eksekusi SQL).	Mode single-database
`fixSql`	Secara otomatis memperbaiki pernyataan SQL yang memiliki kesalahan sintaksis atau logika.	Mode multi-instans & mode single-database
`answerSqlSyntax`	Memberikan penjelasan dan saran untuk masalah sintaksis SQL.	Mode multi-instans & mode single-database
`optimizeSql`	Menganalisis dan mengoptimalkan pernyataan SQL untuk meningkatkan efisiensi eksekusi.	Mode multi-instans & mode single-database