Condividi tramite


Panoramica degli strumenti SQL di Azure per il server MCP di Azure

Il server MCP di Azure consente di gestire le risorse del database SQL di Azure usando i prompt del linguaggio naturale. Questo riferimento agli strumenti SQL di Azure fornisce comandi completi per la gestione di database, server, regole del firewall e pool elastici senza sintassi complessa.

Il database SQL di Azure è un motore di database PaaS (Platform as a Service) completamente gestito che gestisce la maggior parte delle funzioni di gestione del database, ad esempio l'aggiornamento, l'applicazione di patch, i backup e il monitoraggio senza coinvolgimento dell'utente.

Note

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 di seguito. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.

Database: Creare un database

Creare un nuovo database in un server SQL di Azure esistente. Questo comando crea un database con livelli di prestazioni configurabili, limiti di dimensioni e altre impostazioni.

Alcuni prompt di esempio includono:

  • Creare un database: "Creare un nuovo database SQL denominato 'sales-data' nel server 'prod-sql-server' nel gruppo di risorse 'my-resource-group'"
  • Specificare il livello: "Creare un database SQL 'inventory' con livello Basic nel server 'eastus-sql' nel gruppo di risorse 'my-resource-group'"
  • Gruppo di risorse: "Creare un nuovo database denominato "customer-info" in SQL Server 'analytics-sql' nel gruppo di risorse 'my-resource-group'"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome di Azure SQL Server.
Banca dati Required Nome del database SQL di Azure.
Nome SKU Opzionale Nome DELLO SKU per il database, ad esempio , BasicS0, P1, GP_Gen5_2.
Livello SKU Opzionale Livello SKU per il database , ad esempio , BasicStandardPremium, , . GeneralPurpose
Capacità SKU Opzionale Capacità sku (DTU o vCore count) per il database.
Collation Opzionale Regole di confronto per il database , ad esempio SQL_Latin1_General_CP1_CI_AS.
Byte di dimensioni massime Opzionale Dimensione massima del database in byte.
Nome pool elastico Opzionale Nome del pool elastico a cui assegnare il database.
Ridondanza della zona Opzionale Indica se il database deve essere con ridondanza della zona.
Scalabilità in lettura Opzionale Opzione Di scalabilità in lettura per il database (Enabled o Disabled).

Hint per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ❌ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Database: Eliminare il database

Eliminare un database SQL.

Alcuni prompt di esempio includono:

  • Eliminare il database: "Eliminare il database SQL 'sales-data' dal server 'prod-sql-server' nel gruppo di risorse 'my-resource-group'"
  • Rimuovere dal gruppo di risorse: "Rimuovere il database 'inventory' da SQL Server 'eastus-sql' nel gruppo di risorse 'my-resource-group'"
  • Eliminare per nome: "Eliminare il database denominato 'customer-info' nel server 'analytics-sql' nel gruppo di risorse 'my-resource-group'"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome di Azure SQL Server.
Banca dati Required Nome del database SQL di Azure.

Hint per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Database: elencare i database

Elenca tutti i database nella risorsa cloud con i dettagli relativi a configurazione, stato, SKU e prestazioni. Usare quando è necessario: visualizzare l'inventario del database, controllare lo stato del database, confrontare le configurazioni del database o trovare i database per le operazioni di gestione.

Alcuni prompt di esempio includono:

  • Elencare i database: "Mostra tutti i database nel server 'eastus-sql' nel gruppo di risorse 'my-resource-group'"
  • Inventario database: "Elencare i database nel gruppo di risorse 'my-resource-group' nel server 'eastus-sql'"
  • Controllare lo stato del database: "Quali database sono attualmente attivi nel server 'eastus-sql' nel gruppo di risorse 'my-resource-group'?"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome della risorsa.

Hint per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Database: Rinomina database

Rinominare un database esistente in un nuovo nome all'interno dello stesso server SQL di Azure.

Alcuni prompt di esempio includono:

  • Rinominare il database: "Rinominare il database SQL 'sales-data' nel server 'prod-sql-server' nel gruppo di risorse 'my-resource-group' in 'sales-archive'"
  • Rinominare con un server esplicito: "Rinominare il database SQL di Azure 'inventory' in 'inventory-2025' nel server 'eastus-sql' nel gruppo di risorse 'my-resource-group'"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome di Azure SQL Server.
Banca dati Required Nome del database SQL di Azure.
Nuovo nome del database Required Nuovo nome per il database SQL di Azure.

Hint per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ❌ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Database: mostra i dettagli del database

Recupera informazioni dettagliate su un database specifico. Usare questo comando per controllare la configurazione, il livello di prestazioni, le dimensioni e altre caratteristiche del database.

Alcuni prompt di esempio includono:

  • Visualizzare i dettagli del database: "Mostra i dettagli per il database 'inventory' nel server 'eastus-sql' nel gruppo di risorse 'my-resource-group'"
  • Controllare la configurazione del database: "È possibile indicare le specifiche e lo stato corrente del database customer-db nel server 'prod-sql-server' nel gruppo di risorse 'my-resource-group'?"
  • Controllare il livello di prestazioni: "Quale livello di servizio per il server 'prod-sql-server' nel gruppo di risorse 'my-resource-group' è il database di analisi usato?"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome della risorsa.
Banca dati Required Nome del database nella risorsa.

Hint per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Database: Aggiornare il database

Aggiornare le impostazioni di configurazione per un database SQL di Azure esistente.

Alcuni prompt di esempio includono:

  • Aggiornare il livello di prestazioni: "Aggiornare il livello di prestazioni del database SQL 'sales-data' nel server 'prod-sql-server' nel gruppo di risorse 'my-resource-group'"
  • Ridimensionare lo SKU del database: "Ridimensionare il database SQL 'inventory' nel server 'eastus-sql' nel gruppo di risorse 'my-resource-group' per usare lo SKU S3"
  • Modificare le impostazioni del database: "Aggiornare il database SQL di Azure 'analytics' per usare il livello Premium nel server 'eastus-sql' nel gruppo di risorse 'my-resource-group'"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome di Azure SQL Server.
Banca dati Required Nome del database SQL di Azure.
Nome SKU Opzionale Nome DELLO SKU per il database, ad esempio , BasicS0, P1, GP_Gen5_2.
Livello SKU Opzionale Livello SKU per il database , ad esempio , BasicStandardPremium, , . GeneralPurpose
Capacità SKU Opzionale Capacità sku (DTU o vCore count) per il database.
Collation Opzionale Regole di confronto per il database , ad esempio SQL_Latin1_General_CP1_CI_AS.
Byte di dimensioni massime Opzionale Dimensione massima del database in byte.
Nome pool elastico Opzionale Nome del pool elastico a cui assegnare il database.
Ridondanza della zona Opzionale Indica se il database deve essere con ridondanza della zona.
Scalabilità in lettura Opzionale Opzione Di scalabilità in lettura per il database (Enabled o Disabled).

Hint per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Autenticazione server: elencare gli amministratori di Microsoft Entra

Elenca gli amministratori di Microsoft Entra ID configurati per un server SQL di Azure. Usare questo comando per gestire e controllare l'accesso basato sulle identità alla risorsa.

Alcuni prompt di esempio includono:

  • Controllare gli utenti amministratori: "Mostra tutti gli amministratori di Microsoft Entra per il server 'prod-sql' nel gruppo di risorse 'my-resource-group'"
  • Accesso all'identità: "Elencare gli amministratori di Microsoft Entra per SQL Server 'finance-db' nel gruppo di risorse 'my-resource-group'"
  • Controllo di sicurezza: "Chi ha accesso amministratore al server 'prod-sql-server' nel gruppo di risorse 'my-resource-group'?"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome della risorsa di SQL Server di Azure.

Hint per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Server: Crea server

Crea un nuovo server SQL di Azure nel gruppo di risorse e nella posizione specificati.

Alcuni prompt di esempio includono:

  • Creare SQL Server: "Creare un nuovo server SQL di Azure denominato "prod-sql-server" nel gruppo di risorse 'my-resource-group' con l'utente amministratore 'sqladmin' e la password 'MyStr0ngP@ssw0rd!' negli Stati Uniti orientali"
  • Specificare l'utente amministratore: "Creare un server SQL di Azure con nome 'eastus-sql' nel gruppo di risorse 'my-resource-group' nella località 'Stati Uniti orientali' con l'utente amministratore 'sqladmin' e la password 'SecureP@ss123!'"
  • Configurare il server nel gruppo di risorse: "Configurare un nuovo server SQL denominato 'analytics-sql' per l'utente amministratore 'sqladmin' con password 'Analytics2024!' negli Stati Uniti occidentali 2 nel gruppo di risorse 'my-resource-group' con accesso alla rete pubblica abilitato"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome della risorsa di SQL Server di Azure.
Utente amministratore Required Nome dell'account di accesso dell'amministratore per SQL Server.
Password amministratore Required Password amministratore per SQL Server.
Ubicazione Required Posizione dell'area di Azure in cui viene creato il server SQL.
Versione Opzionale Versione di SQL Server da creare, ad esempio 12.0.
Accesso alla rete pubblica Opzionale Indica se l'accesso alla rete pubblica è abilitato per SQL Server (Enabled o Disabled).

Hint per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ❌ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Server: eliminare il server

Elimina un server SQL di Azure e tutti i relativi database dal gruppo di risorse specificato.

Alcuni prompt di esempio includono:

  • Eliminare SQL Server: "Eliminare il server SQL di Azure 'prod-sql-server' dal gruppo di risorse 'my-resource-group'"
  • Rimuovere dalla sottoscrizione: "Rimuovere il server SQL 'test-sql-server' dal gruppo di risorse 'my-resource-group'"
  • Eliminazione permanente: "Eliminare definitivamente 'analytics-sql' di SQL Server nel gruppo di risorse 'my-resource-group' in modo permanente"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome della risorsa di SQL Server di Azure.
Forza Opzionale Forzare l'eliminazione del server senza richieste di conferma.

Hint per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Server: elencare i server

Elenca i server SQL di Azure all'interno di un gruppo di risorse.

Alcuni prompt di esempio includono:

  • Elencare i server SQL: "Elencare tutti i server SQL di Azure nel gruppo di risorse 'my-resource-group'"
  • Mostra tutti i server: "Mostra tutti i server SQL disponibili nel gruppo di risorse 'my-resource-group'"
  • Inventario server: "Quali server SQL sono presenti nel gruppo di risorse 'my-resource-group'?"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Gruppo di risorse Opzionale Gruppo di risorse in base al quale filtrare i server.

Hint per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Server: mostra i dettagli del server

Recupera informazioni dettagliate su un server SQL di Azure, tra cui la configurazione, lo stato e le proprietà, ad esempio il nome di dominio completo, la versione, l'account di accesso amministratore e le impostazioni di accesso alla rete.

Alcuni prompt di esempio includono:

  • Visualizzare i dettagli del server: "Visualizzare i dettagli del server SQL di Azure 'prod-sql-server' nel gruppo di risorse 'my-resource-group'"
  • Ottenere la configurazione: "Ottenere i dettagli di configurazione per SQL Server 'analytics-sql' nel gruppo di risorse 'my-resource-group'"
  • Visualizzare le proprietà: "Visualizzare le proprietà di SQL Server 'eastus-sql' nel gruppo di risorse 'my-resource-group'"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome della risorsa di SQL Server di Azure.

Hint per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Firewall del server: regole di elenco

Elenca tutte le regole del firewall per una risorsa specifica. Usare questo comando per gestire ed esaminare le impostazioni di accesso alla rete per la risorsa.

Alcuni prompt di esempio includono:

  • Visualizzare le impostazioni del firewall: "Mostra tutte le regole del firewall per il mio 'prod-sql-server' nel gruppo di risorse 'my-resource-group'"
  • Controllare i controlli di accesso: "Sono presenti regole del firewall per il server SQL analytics-db nel gruppo di risorse 'my-resource-group'?"
  • Controllo di sicurezza: "Elencare le regole del firewall per il server finance-db nel gruppo di risorse 'my-resource-group'"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome della risorsa di SQL Server di Azure.

Hint per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Firewall del server: Creare una regola

Crea una regola del firewall per una risorsa. Le regole del firewall controllano gli indirizzi IP autorizzati a connettersi alla risorsa. È possibile specificare un singolo indirizzo IP (impostando l'indirizzo IP iniziale e finale sullo stesso valore) o un intervallo di indirizzi IP.

Alcuni prompt di esempio includono:

  • Aggiungere una regola del firewall: "Creare una regola del firewall denominata "office-access" per il server 'prod-sql' nel gruppo di risorse 'my-resource-group' che consente l'intervallo IP 192.168.1.1 a 192.168.1.100"
  • Impostare l'intervallo di accesso: "È necessario impostare una regola del firewall "test" nel server 'analytics-sql' nel gruppo di risorse 'my-resource-group' per consentire l'accesso dall'intervallo IP 10.0.0.1 a 10.0.0.255"
  • Consenti indirizzo IP singolo: "Creare una regola del firewall "allow-single-ip" per consentire l'accesso dall'indirizzo IP 203.0.113.5 al server SQL 'production-uswest' nel gruppo di risorse 'my-resource-group'"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome della risorsa di SQL Server di Azure.
Regola del firewall Required Nome della regola del firewall.
Indirizzo IP iniziale Required Indirizzo IP iniziale dell'intervallo di regole del firewall.
Indirizzo IP finale Required Indirizzo IP finale dell'intervallo di regole del firewall.

Hint per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ❌ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Firewall del server: eliminare la regola

Elimina una regola del firewall da una risorsa. Questa operazione rimuove la regola del firewall specificata, limitando potenzialmente l'accesso per gli indirizzi IP consentiti in precedenza da questa regola. Se la regola non esiste, non viene restituito alcun errore.

Alcuni prompt di esempio includono:

  • Rimuovere la regola del firewall: "Eliminare la regola del firewall denominata "office-access" dal server 'prod-sql' nel gruppo di risorse 'my-resource-group'"
  • Revocare l'accesso: "Revocare la regola del firewall 'temp-access' nel server 'test-sql' nel gruppo di risorse 'my-resource-group'"
  • Eliminare la regola di accesso: "Rimuovere la regola del firewall "accesso guest" dal server SQL di sviluppo nel gruppo di risorse 'my-resource-group'"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome della risorsa di SQL Server di Azure.
Regola del firewall Required Nome della regola del firewall.

Hint per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Pool elastici: elencare i pool elastici

Elenca tutti i pool elastici per una risorsa specifica. I pool elastici sono una soluzione di allocazione delle risorse che consente di gestire e ridimensionare più database con esigenze di risorse variabili.

Alcuni prompt di esempio includono:

  • Visualizzare i pool di risorse: "Mostra tutti i pool elastici nel server 'main-sql' nel gruppo di risorse 'my-resource-group'"
  • Controllare l'elasticità: "Elencare i pool elastici in esecuzione nel server SQL del database del cliente nel gruppo di risorse "my-resource-group"
  • Inventario pool: "Quali pool elastici vengono distribuiti in SQL Server 'main-sql' nel gruppo di risorse 'my-resource-group'?"
Parameter Obbligatorio o facoltativo Description
Gruppo di risorse Required Nome del gruppo di risorse di Azure. Si tratta di un contenitore logico per le risorse di Azure.
Server Required Nome della risorsa di SQL Server di Azure.

Hint per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌