Strumenti del server MCP di Azure per Database di Azure per MySQL

Gli strumenti del server MCP di Azure consentono di gestire server, database, impostazioni di configurazione e schemi di Database di Azure per MySQL. È possibile usare gli strumenti per ottenere ed elencare server e database, eseguire query su schemi di tabella e dati e impostare i parametri del server usando i prompt del linguaggio naturale.

Database di Azure per MySQL è un servizio di database relazionale gestito basato sull'edizione community di MySQL. Per altre informazioni, vedere la documentazione di Database di Azure per MySQL.

Annotazioni

Parametri degli strumenti: gli strumenti del server MCP di Azure definiscono i parametri per i dati necessari per completare le attività. Alcuni di questi parametri sono specifici di ogni strumento e sono documentati qui. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.

Ottenere i database dei server MySQL

Elenca i server, i database o le tabelle di Database di Azure per MySQL nella tua sottoscrizione. Per impostazione predefinita, questo strumento restituisce tutti i server nella sottoscrizione. Specificare il resource-group parametro per restituire i server in un gruppo di risorse. Specificare il server parametro per elencare i database in un server oppure specificare entrambi i server parametri e database per elencare le tabelle in un database.

Alcuni prompt di esempio includono:

  • "Elencare tutti i server MySQL nella sottoscrizione."
  • "Mostra i server MySQL nel gruppo di risorse 'web-rg'".
  • "Quali server MySQL si trovano nel gruppo di risorse 'rg-staging'?"
  • "Elencare tutti i database MySQL nel server 'mysql-server-01' all'interno del gruppo di risorse 'rg-prod' usando il nome utente 'dbadmin'".
  • "Mostra i database MySQL nel server 'mysql-dbserver' per il gruppo di risorse 'rg-dev' con nome utente 'mysqluser'".
  • "Elencare tutte le tabelle nel database MySQL 'salesdb' nel server 'mysql-server-01' nel gruppo di risorse 'rg-prod' usando il nome utente 'dbadmin'".
  • "Mostra le tabelle nel database 'inventory' nel server 'mysql-dbserver' per il gruppo di risorse 'rg-test' con nome utente 'mysqluser'".
Parametro Obbligatorio o facoltativo Description
Gruppo di risorse Opzionale Nome del gruppo di risorse di Azure che contiene le risorse. Omettere questo parametro per elencare tutti i server nella sottoscrizione.
Nome utente Opzionale Nome utente per accedere al server di Database di Azure per MySQL. Obbligatorio quando si specifica il parametro Nome server per elencare database o tabelle.
Nome del database Opzionale Nome del database di Azure per MySQL da cui elencare le tabelle. Richiede il parametro Nome server .
Nome server Opzionale Nome del server di Azure Database per MySQL da cui elencare i database.

Suggerimenti per l'annotazione degli strumenti

Distruttivo Idempotente Open World Sola lettura Secret Locale richiesta
❌ ✅ ❌ ✅ ❌ ❌

Eseguire query sul database MySQL

Lo strumento MCP (Model Context Protocol) esegue una query SQL SELECT sicura e di sola lettura su un database di Azure Database per MySQL Server Flessibile. Usare questo strumento per recuperare o controllare i dati della tabella senza modificarli. Lo strumento rifiuta istruzioni non-SELECT, ad esempio INSERT, UPDATE, DELETE, REPLACE, MERGE, TRUNCATE, ALTER, CREATE e DROP. Rifiuta anche comandi SQL multipli, commenti che nascondono scritture, controllo delle transazioni (BEGIN/COMMIT/ROLLBACK), INTO OUTFILE, e altre parole chiave distruttive. Questo strumento esegue solo una singola SELECT istruzione per garantire l'integrità dei dati.

Per ottenere risultati ottimali, elencare le colonne necessarie invece di usare SELECT *. Aggiungere WHERE filtri, usare LIMIT/OFFSET per il paging e aggiungere ORDER BY per i risultati deterministici. Evitare di restituire dati sensibili non necessari.

Alcuni prompt di esempio includono:

  • Esegui la query 'SELECT id, name, email FROM customers WHERE id > 100 ORDER BY name LIMIT 50' sul database 'ecommerce_db' nel gruppo di risorse 'rg-prod' sul server 'mysql-prod-server' come utente 'readonlyuser'.
Parametro Obbligatorio o facoltativo Description
Nome del database Obbligatorio Database MySQL a cui accedere.
Quesito Obbligatorio Query da eseguire su un database MySQL.
Gruppo di risorse Obbligatorio Nome del gruppo di risorse di Azure. Questo gruppo di risorse è un contenitore logico per le risorse di Azure.
Nome server Obbligatorio Server MySQL a cui accedere.
Nome utente Obbligatorio Nome utente per accedere al server MySQL.

Suggerimenti per l'annotazione degli strumenti

Distruttivo Idempotente Open World Sola lettura Secret Locale richiesta
❌ ✅ ❌ ✅ ❌ ❌

Ottenere la configurazione del server

Questo strumento fa parte degli strumenti MCP (Model Context Protocol). Recupera i dettagli completi di configurazione per un'istanza specificata di Database di Azure per MySQL Flexible Server. Lo strumento restituisce le impostazioni del server, i parametri delle prestazioni, le configurazioni di sicurezza e le caratteristiche operative che consentono di gestire e ottimizzare il database. L'output è JSON e include ServerName, Location, Version, SKU, StorageSizeGB, BackupRetentionDays e GeoRedundantBackup.

Alcuni prompt di esempio includono:

  • "Mostra la configurazione del server MySQL 'mysql-prod' nel gruppo di risorse 'rg-prod' con l'utente 'dbadmin'".
Parametro Obbligatorio o facoltativo Description
Gruppo di risorse Obbligatorio Nome del gruppo di risorse di Azure che contiene il server.
Nome server Obbligatorio Nome dell'istanza di server flessibile di Azure Database per MySQL.

Suggerimenti per l'annotazione degli strumenti

Distruttivo Idempotente Open World Sola lettura Secret Locale richiesta
❌ ✅ ❌ ✅ ❌ ❌

Ottenere il parametro del server

Questo strumento MCP (Model Context Protocol) recupera il valore corrente di un singolo parametro di configurazione del server nel server flessibile di Database di Azure per MySQL. Usare questo strumento per esaminare un'impostazione, ad esempio max_connections, wait_timeouto slow_query_log, prima di modificarla. Questo strumento richiede un account utente con privilegi sufficienti per leggere i parametri del server.

Alcuni prompt di esempio includono:

  • "Mostra il valore del parametro 'connection_timeout' nel gruppo di risorse 'rg-prod' per il server MySQL 'my-mysql-server' con nome utente 'dbadmin'".
Parametro Obbligatorio o facoltativo Description
Parameter Obbligatorio Parametro MySQL a cui accedere.
Gruppo di risorse Obbligatorio Nome del gruppo di risorse di Azure. Questo gruppo di risorse è un contenitore logico per le risorse di Azure.
Nome server Obbligatorio Server MySQL a cui accedere.

Suggerimenti per l'annotazione degli strumenti

Distruttivo Idempotente Open World Sola lettura Secret Locale richiesta
❌ ✅ ❌ ✅ ❌ ❌

Aggiornare il parametro del server

Questo strumento, incluso nel protocollo MCP (Model Context Protocol), aggiorna una singola impostazione di configurazione in un server di Database di Azure per MySQL. Specificare il gruppo di risorse, il nome del server, il nome utente e il valore da impostare.

Alcuni prompt di esempio includono:

  • "Impostare il parametro 'connection_timeout' sul valore '20' nel nome del server 'mysql-prod' nel gruppo di risorse 'rg-prod' con nome utente 'dbadmin'".
Parametro Obbligatorio o facoltativo Description
Parameter Obbligatorio Parametro MySQL a cui accedere.
Gruppo di risorse Obbligatorio Nome del gruppo di risorse di Azure. Questo gruppo di risorse è un contenitore logico per le risorse di Azure.
Nome server Obbligatorio Server MySQL a cui accedere.
Valore Obbligatorio Valore da impostare per il parametro MySQL.

Suggerimenti per l'annotazione degli strumenti

Distruttivo Idempotente Open World Sola lettura Secret Locale richiesta
✅ ✅ ❌ ❌ ❌ ❌

Examples

  • Impostare autocommit su 'ON' per il server 'my-mysql-server' nel gruppo di risorse 'prod-rg' usando l'utente 'dbadmin'.
  • Imposta slow_query_log su 'ON' per il server 'analytics-db' nel gruppo di risorse 'analytics-rg' utilizzando l'utente 'monitor'.
  • Impostare max_connections su '200' per il server 'web-db-server' nel gruppo di risorse 'web-rg' usando l'utente 'dbadmin'.

Ottenere lo schema della tabella

Questo strumento MCP (Model Context Protocol) recupera informazioni dettagliate sullo schema per una tabella specifica in un'istanza del server flessibile di Database di Azure per MySQL. Restituisce metadati completi, tra cui definizioni di colonna, tipi di dati, vincoli, indici e relazioni. Questi metadati consentono di comprendere la struttura delle tabelle e supportare lo sviluppo di applicazioni.

Alcuni prompt di esempio includono:

  • "Mostra lo schema della tabella 'orders' nel database 'salesdb' nel server 'mysql-prod' all'interno del gruppo di risorse 'rg-db-prod' come utente 'dbadmin'".
Parametro Obbligatorio o facoltativo Description
Nome del database Obbligatorio Database MySQL a cui accedere.
Gruppo di risorse Obbligatorio Nome del gruppo di risorse di Azure che contiene il server.
Nome server Obbligatorio Server MySQL che ospita il database.
Nome della tabella Obbligatorio La tabella per cui recuperare le informazioni sullo schema.
Nome utente Obbligatorio Nome utente da autenticare nel server MySQL.

Suggerimenti per l'annotazione degli strumenti

Distruttivo Idempotente Open World Sola lettura Secret Locale richiesta
❌ ✅ ❌ ✅ ❌ ❌

Contenuti correlati

  • Last updated on