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

Model Context Protocol (MCP) membentuk saluran komunikasi antara model bahasa besar dan alat eksternal. Topik ini menjelaskan cara mengonfigurasi Data Management (DMS) MCP. Anda kemudian dapat menggunakan server MCP universal multi-cloud untuk mengakses database yang dihosting di DMS secara aman.

Informasi latar belakang

MCP database tradisional memiliki beberapa kelemahan berikut:

Kompatibilitas terbatas dengan database heterogen: MCP hanya mendukung koneksi dan operasi pada satu jenis database, sehingga tidak memungkinkan pengelolaan terpadu lintas platform database yang berbeda.
Tidak ada pengelolaan akun dan izin terpusat: MCP tidak menyediakan manajemen terpusat untuk akun dan kata sandi. Ketergantungan pada pemeliharaan manual menciptakan risiko keamanan.
Operasi SQL terbatas: MCP hanya mendukung input manual SQL dasar dan standar, serta tidak mampu mengurai sintaks kompleks atau non-standar.
Tidak mendukung NL2SQL: MCP tidak mendukung secara native kueri natural language to SQL (NL2SQL). Integrasi model bahasa besar eksternal diperlukan untuk mengaktifkan kemampuan ini.

DMS MCP mengatasi masalah tersebut dengan menyediakan akses data terpadu bagi model bahasa besar berbasis AI. DMS MCP menggunakan antarmuka terstandarisasi untuk mengatasi isu kompatibilitas dan keamanan. Fitur-fitur baru juga disediakan, seperti kemampuan memperoleh informasi skema, menghasilkan kode Data Access Object (DAO), serta melakukan analisis struktural. Selain itu, DMS MCP menggunakan routing SQL otomatis untuk mengambil data secara akurat dan mendukung aplikasi bisnis tingkat lanjut.

Fitur utama DMS MCP

Akses aman
- Hosting kredensial akun yang aman: DMS mengelola kredensial akun database secara aman, menghilangkan kebutuhan pemeliharaan manual dan mencegah kebocoran informasi sensitif.
- Akses melalui jaringan internal: Anda dapat mengakses database melalui jaringan internal tanpa mengekspos alamat IP publik, sehingga menjamin keamanan dan privasi data.
- Kontrol izin detail halus: DMS MCP mendukung kontrol akses detail halus pada level instans, database, tabel, bidang, dan baris, mencegah operasi tidak sah dan melindungi keamanan data.
- Deteksi dan intersepsi SQL berisiko tinggi: DMS memiliki aturan keamanan bawaan untuk mendeteksi dan mengintersepsi pernyataan SQL berpotensi berisiko tinggi secara real-time, sehingga mencegah risiko keamanan.
- Audit dan pelacakan SQL: DMS mencatat log operasi untuk semua pernyataan SQL, memungkinkan pelacakan lengkap dan audit kepatuhan guna memenuhi persyaratan regulasi.
Kueri data cerdas
- Algoritma NL2SQL bawaan: Algoritma NL2SQL bawaan secara cerdas mencocokkan tabel data berdasarkan pertanyaan dalam bahasa alami Anda, memahami makna bisnis dari tabel, menghasilkan dan mengeksekusi kueri SQL, serta mengembalikan hasil dengan cepat.
- Basis pengetahuan yang dapat dikustomisasi: DMS memiliki metadata dan basis pengetahuan kueri bawaan. Anda dapat mengkustomisasi pengetahuan bisnis dan pola kueri untuk menciptakan kemampuan kueri cerdas yang disesuaikan dengan skenario bisnis Anda.
Dukungan untuk berbagai sumber data
- Pengelolaan berbagai sumber data: Anda dapat mengelola lebih dari 40 database dan gudang data utama, memungkinkan akses terpadu ke berbagai jenis data.
- Pengelolaan multi-lingkungan terpadu: Anda dapat mengelola sumber data secara terpusat di berbagai lingkungan, seperti development, testing, dan production, sehingga meningkatkan efisiensi O&M.
- Integrasi multi-platform mulus: DMS MCP mencakup platform cloud utama, seperti Alibaba Cloud dan AWS, serta database dan gudang data yang dikelola sendiri, sehingga secara efektif mengurangi biaya pemeliharaan.

Alur aplikasi

Diagram berikut menunjukkan alur permintaan akses data untuk klien.

Skenario

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

Bagian ini menjelaskan perbedaan antara alur produksi tradisional dan alur pengembangan cerdas yang menggunakan DMS MCP.

Alur produksi tradisional: Pertama, Anda harus mengeksekusi secara manual pernyataan SQL pembuatan tabel menggunakan alat pengembangan database. Kemudian, Anda harus menulis kode DAO di integrated development environment (IDE). Selanjutnya, Anda harus mengisi database menggunakan alat database. Terakhir, Anda dapat melihat pratinjau data.
Alur pengembangan cerdas: Pertama, Anda dapat merancang tabel menggunakan IDE AI. Kemudian, DMS MCP secara otomatis mengeksekusi pernyataan SQL pembuatan tabel, IDE secara otomatis menghasilkan kode DAO, dan MCP secara cerdas mengisi database. Terakhir, Anda dapat melihat pratinjau data.

Skenario 2: Langsung peroleh statistik data menggunakan DMS NL2SQL

Departemen analisis pasar dapat menggunakan fitur DMS NL2SQL untuk langsung memperoleh statistik data dari kueri bahasa alami, sehingga mempermudah analisis tren data.

Biaya

Layanan DMS MCP sedang dalam masa pratinjau publik dan dapat digunakan secara gratis.

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

Persiapan

Sebelum menggunakan DMS MCP untuk mengakses instansiasi basis data yang dihosting di DMS, Anda harus menambahkan instans tersebut ke DMS dan mengaktifkan security hosting. Anda dapat menambahkan instans dengan cara berikut:

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

Catatan

Metode ini hanya mendukung instans database Alibaba Cloud.
Untuk instans yang ditambahkan menggunakan tool ini, DMS secara default mengaktifkan security hosting.

Server DMS MCP menyediakan tool addInstance untuk membantu Anda menambahkan instans ke DMS dengan cepat. Pada agen (aplikasi AI percakapan) yang terhubung ke DMS MCP, instruksikan model bahasa besar untuk menambahkan instans. Berikan detail instans, seperti ID instans, akun database, kata sandi, dan wilayah. Model akan secara otomatis memanggil tool yang sesuai.

Metode 2: Tambahkan instans database Alibaba Cloud, cloud pihak ketiga, atau database yang dikelola sendiri menggunakan konsol DMS

Catatan

Metode ini mendukung penambahan instans database Alibaba Cloud, cloud pihak ketiga, atau database yang dikelola sendiri. Langkah-langkah berikut menggunakan contoh instans ApsaraDB RDS for MySQL.

Login ke DMS 5.0.
Pada area Database Instances di sisi kiri konsol, klik ikon Add Instance .
Catatan
Anda juga dapat memilih Data Assets > Instance Management dari bilah menu dan klik New untuk menambahkan instans.

Pada halaman Add Instance, masukkan informasi instans.

Kategori	Item Konfigurasi	Deskripsi
Data Source	-	Nilai default adalah Alibaba Cloud-MySQL. Anda dapat memilih tipe database lainnya.
Basic Information	Database Type	Pilih tipe instans database. Catatan Setelah Anda memilih tipe database, DMS secara otomatis memperbarui item konfigurasi pada halaman Basic Information.
	Instance Region	Pilih wilayah tempat instans database berada.
	Other primary accounts	Item konfigurasi ini muncul jika Anda memilih Cross-account Instance. Pilih Akun Alibaba Cloud pemilik instans database. Catatan Jika Akun Alibaba Cloud tidak ada dalam daftar, Anda dapat mengklik Add User untuk menambahkan akun pemilik instans. Untuk informasi lebih lanjut, lihat Tambahkan pengguna.
	Entry Method	Pilih cara menambahkan instans database. Anda dapat menambahkan instans berdasarkan Instance ID atau Connection String.
	Instance ID atau Connection String	Masukkan Instance ID atau Connection String. Catatan String koneksi terdiri dari titik akhir internal dan port internal. Contoh untuk ApsaraDB RDS for MySQL: rm-XXXXXXX.mysql.rds.aliyuncs.com:3306.
	Security Hosting	Pertahankan opsi ini diaktifkan. Aktifkan security hosting untuk menghindari kontak langsung pengguna dengan kredensial akun dan menerapkan kontrol izin detail halus.
	Access Mode	Mode akses tersedia sebagai berikut: Log On With An Account And Password: Anda harus memasukkan secara manual akun dan password database yang telah Anda buat. Log On With A KMS Credential: Pilih secara manual kredensial RDS yang dibuat di KMS untuk login ke database. Catatan Parameter ini hanya muncul saat Anda menambahkan instans RDS.
	Value-added Feature Package	Pilih paket fitur sesuai kebutuhan. Security Collaboration atau Stable Change (pilih salah satu): Security Collaboration mendukung semua kemampuan Stable Change dan menyediakan fitur DevOps. Anda dapat mengkustomisasi alur pengembangan dan persetujuan secara fleksibel. Stable Change menyediakan solusi untuk operasi database yang lebih stabil, seperti lockless change dan SQL Audit. Catatan Jika Anda tidak memilih paket fitur Security Collaboration atau Stable Change, instans secara default menggunakan mode Flexible Management. Sensitive Data Protection: Fitur ini memungkinkan Anda mengontrol dan mendesensitisasi data sensitif. Aktifkan fitur ini sesuai kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Aktifkan Sensitive Data Protection.
	Security Rule	Item konfigurasi ini muncul jika Anda memilih Security Collaboration sebagai paket fitur. Anda dapat memilih aturan keamanan default atau aturan keamanan kustom untuk kontrol detail halus terhadap database.
	Classification And Grading Template	Item konfigurasi Classification and Grading Template hanya muncul saat Anda mengaktifkan Sensitive Data Protection.
Advanced Information	-	Anda dapat mempertahankan nilai default untuk parameter pada bagian Advanced Information. Untuk informasi lebih lanjut tentang parameter tersebut, lihat Tambahkan instans database ApsaraDB.

Setelah memasukkan informasi yang diperlukan, klik Test Connection di pojok kiri bawah.
Catatan
Jika pengujian koneksi gagal, tinjau pesan error dan periksa kembali informasi instans yang Anda masukkan.
Setelah muncul pesan Connection Successful, klik Submit.
Instans database kini telah ditambahkan ke DMS.

Untuk informasi lebih lanjut tentang cara menambahkan instans, lihat Tambahkan instans database ApsaraDB dan Tambahkan instans database cloud pihak ketiga atau yang dikelola sendiri.

Mode penggunaan

Server DMS MCP mendukung dua mode penggunaan.

Mode

Skenario

Mode 1: Mode multi-instans

Mode ini cocok untuk mengelola dan mengakses instans database di berbagai lingkungan. Anda dapat menambahkan semua instans Anda ke DMS, lalu mengelolanya menggunakan Server DMS MCP.

Mode 2: Mode single-database

Mode ini cocok untuk mengakses satu database saja. Anda dapat mengonfigurasi parameter CONNECTION_STRING di server untuk menentukan database yang akan diakses. Saat layanan dimulai, Server DMS MCP langsung mengakses database yang ditentukan.

Format: CONNECTION_STRING = dbName@host:port.

Pada area daftar database di sisi kiri halaman DMS, Anda dapat menemukan dan mengklik ganda nama database, lalu menggunakan jendela SQL untuk memperoleh nilai CONNECTION_STRING dengan cepat.

Memulai dengan cepat

Solusi 1: Jalankan menggunakan paket PyPI

Peroleh AccessKey atau Token Layanan Keamanan (STS) yang memiliki izin AliyunDMSFullAccess.
Untuk informasi lebih lanjut tentang cara memberikan izin, lihat Pengelolaan Izin.

Tambahkan konfigurasi berikut ke file konfigurasi klien MCP.

Multi-instance 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": "sts_security_token is optional. It is required when you use an 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": "sts_security_token is optional. It is required when you use an STS token.",
        "CONNECTION_STRING": "dbName@host:port"
      }
    }
  }
}

Solusi 2: Gunakan layanan MCP yang dihosting di DMS

Login ke DMS 5.0.
Aktifkan layanan MCP.
1. Arahkan pointer mouse ke ikon MCP di pojok kanan bawah, lalu klik Enable Now pada kotak dialog yang muncul.
2. Pilih cakupan untuk layanan MCP.
  - All Databases: Semua database yang ditambahkan dalam bagian Persiapan.
  - Specified Database: Salah satu database yang ditambahkan dalam bagian Persiapan.
    Catatan
    Jika Anda memilih Specified Database, Anda juga harus memilih database target.
3. Klik Confirm Enable.
Setelah layanan MCP diaktifkan, lihat informasi konfigurasi MCP.
Catatan
Anda dapat mengarahkan pointer mouse ke ikon MCP di pojok kanan bawah untuk melihat informasi konfigurasi MCP pada kotak dialog yang muncul.
Integrasikan layanan DMS MCP ke agen AI Anda dan gunakan sesuai kebutuhan.
Catatan
- Saat menggunakan layanan DMS MCP, atur Bearer Token untuk otentikasi berdasarkan bidang Authorization dalam MCP Configuration Example dari Langkah 3.
- Untuk mengubah cakupan database layanan MCP, Anda harus membatalkan layanan terlebih dahulu. Arahkan pointer mouse ke ikon MCP , klik Cancel Service, lalu klik Confirm Cancel pada kotak dialog. Kemudian, aktifkan kembali layanan MCP.

Solusi 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 Tool	Deskripsi	Mode yang Berlaku
`addInstance`	Menambahkan instans ke DMS. Jika instans sudah ada, informasinya akan dikembalikan.	Mode multi-instans
`listInstances`	Mencari daftar instans di DMS.	Mode multi-instans
`getInstance`	Mendapatkan detail instans berdasarkan host dan port-nya.	Mode multi-instans
`searchDatabase`	Mencari database berdasarkan nama skema.	Mode multi-instans
`getDatabase`	Mendapatkan detail database tertentu.	Mode multi-instans
`listTable`	Mencari tabel data dalam database tertentu.	Mode multi-instans & Mode single-database
`getTableDetailInfo`	Mendapatkan detail tabel data 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 mengajukan permintaan operasi DDL atau DML.	Mode multi-instans & Mode single-database
`getOrderInfo`	Menanyakan detail tiket, termasuk status, alur persetujuan, dan log eksekusi.	Mode multi-instans & Mode single-database
`submitOrderApproval`	Mengajukan tiket ke alur persetujuan untuk dieksekusi setelah disetujui.	Mode multi-instans & Mode single-database
`generateSql`	Mengonversi pertanyaan bahasa alami menjadi pernyataan kueri 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 sintaks atau logika.	Mode multi-instans & Mode single-database
`answerSqlSyntax`	Memberikan penjelasan dan saran untuk masalah sintaks SQL.	Mode multi-instans & Mode single-database
`optimizeSql`	Menganalisis dan mengoptimalkan pernyataan SQL untuk meningkatkan efisiensi eksekusi.	Mode multi-instans & Mode single-database