Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a:✅Base de datos SQL en Microsoft Fabric
Importante
Esta característica se encuentra en versión preliminar.
Skills for Fabric son instrucciones reutilizables que ayudan a un asistente de codificación con IA a comprender las cargas de trabajo de Fabric, APIs, patrones de consulta y mejores prácticas operativas. Las capacidades de SQL Database proporcionan orientación específica para tareas sobre cómo trabajar con SQL Database en Fabric desde un entorno de línea de comandos o de programación basado en agentes.
Este artículo muestra cómo instalar el skill bundle de Fabric, conectar el asistente a tu entorno Fabric y utilizar las habilidades de autoría, consumo y operaciones de bases de datos SQL. Las habilidades guían al asistente; tu identidad, permisos, herramientas y controles de seguridad de Fabric siguen gobernando cada acción.
Prerequisites
- Permiso para acceder al espacio de trabajo de Fabric y realizar las operaciones que solicitas.
-
Una herramienta de codificación de IA, como GitHub Copilot CLI, Claude Code, Visual Studio Code, Cursor, Windsurf u otra
AGENTS.mdherramienta compatible. -
Node.js: necesario para la CLI de GitHub Copilot independiente, que se instala como un paquete npm (
npm install -g @github/copilot). Para ver los pasos de configuración completos, consulte Configuración de GitHub Copilot CLI. -
PowerShell 7: necesario para GitHub Copilot CLI. Compruebe con
pwsh --version. - Git: necesario para clonar repositorios de habilidades para herramientas que no usan la tienda de complementos.
-
CLI de Azure: la mayoría de las operaciones de Fabric requieren autenticación Azure. Después de la instalación, inicie sesión con
az login.
Instala las habilidades de Microsoft Fabric
Abre GitHub Copilot CLI o Claude Code. Tanto GitHub Copilot CLI como Claude Code usan el mismo flujo de trabajo del mercado de complementos.
Añadir el mercado público en GitHub Copilot CLI:
/plugin marketplace add microsoft/skills-for-fabricAgregue las aptitudes para Fabric Marketplace:
/plugin marketplace add microsoft/skills-for-fabricPara ver todos los plugins y habilidades disponibles en el mercado, introduzca:
/plugin marketplace browse fabric-collection.Instale la colección Fabric.
/plugin install fabric-skills@fabric-collectionPara reducir el alcance, instala un paquete enfocado, como
fabric-operations, que incluye lassqldb-clihabilidades:/plugin install fabric-operations@fabric-collectionCierre y reinicie su herramienta para cargar las habilidades:
/quitCompruebe la instalación:
/skills
Habilidades en bases de datos SQL
Las siguientes habilidades son relevantes para la base de datos SQL en Fabric:
| Habilidad | Úselo para | Ejemplo de intención |
|---|---|---|
sqldb-authoring-cli |
Crear y modificar objetos o datos de bases de datos. | Crea una tabla, carga filas, añade un índice o despliega un procedimiento almacenado. |
sqldb-consumption-cli |
Descubriendo el esquema y ejecutando consultas de solo lectura. | Lista tablas, inspecciona columnas, resume pedidos recientes o explica un conjunto de resultados. |
sqldb-operations-cli |
Investigando cuestiones de salud, rendimiento y operativas. | Analizar consultas lentas, identificar bloqueos o revisar el uso de recursos de la base de datos. |
Para consultar el catálogo completo de habilidades disponibles en todas las cargas de trabajo de Fabric, consulta GitHub: Skills for Fabric.
Cómo usar Skills con base de datos SQL en Fabric
Abre un terminal en tu proyecto o carpeta de trabajo.
Escriba
Copiloty seleccioneEnter.
GitHub Copilot se lanza.
Para autenticarte con la identidad de Microsoft que tiene acceso al espacio de trabajo de Fabric objetivo, escribe
az loginy sigue los pasos.
Desarrollar una base de datos SQL
Usa la sqldb-authoring-cli habilidad cuando la tarea cambia de estado en la base de datos. Para crear o actualizar objetos de base de datos con GitHub Copilot, incluye siempre el espacio de trabajo destino, la base de datos, el entorno, el objeto, el esquema esperado, las restricciones y si el asistente debe generar solo un script o ejecutarlo tras tu revisión. Para cambios de esquema o de datos, puedes pedir TRY...CATCH que gestiones errores y realices una reversión de la transacción.
Tip
Comienza con una solicitud de solo lectura para generar sentencias T-SQL y luego revisa cualquier sentencia T-SQL generada antes de ejecutarla.
Por ejemplo, estos prompts de ejemplo pueden usarse para crear y cargar una tabla con datos de muestra.
In the Sales SQL database, create a dbo.CustomerFeedback table with an identity key,
customer ID, feedback text, sentiment, created date, and a foreign key to
dbo.Customer.CustomerID. All columns should be nullable. The create date should
be populated by a default. Generate the T-SQL for review; don't execute it.
Generate 100 sample data rows for the dbo.CustomerFeedback as a single
INSERT statement, referencing rows in the dbo.Customer table.
Generate a TRY...CATCH structure to handle any errors and rollback.
Do not execute the script, let me review.
Explorar y consultar datos
Utiliza la habilidad sqldb-consumption-cli para la detección y el análisis de solo lectura. Pide al asistente que inspeccione primero los metadatos, que califique los nombres de los objetos, limite el tamaño del resultado y explique las suposiciones.
Por ejemplo, utiliza Copilot para consultar metadatos o datos de tablas:
List the user tables and views in the Sales SQL database and describe their relationships.
Don't modify any objects.
Find the top 10 products by revenue in the last 30 days.
Show the T-SQL and summarize the result.
Inspect the available columns before answering:
Which customers have not placed an order in the last 90 days?
Investigar operaciones de base de datos
Utiliza la sqldb-operations-cli habilidad para investigar el rendimiento y la fiabilidad. Proporciona la ventana temporal, el síntoma observado, la carga de trabajo afectada y si el asistente puede recopilar datos diagnósticos.
Por ejemplo, las siguientes consultas investigan problemas de rendimiento actuales o pasados, o ajustan el rendimiento de las consultas.
Investigate why the nightly order-processing query slowed down between 01:00 and 02:00 UTC.
Start with read-only diagnostics and rank the likely causes.
Check for blocking sessions and long-running requests.
Explain the evidence before recommending a mitigation.
Review this execution plan and suggest indexes only when the expected benefit and write overhead are clear.
Lista de verificación para revisar y ejecutar la consulta T-SQL
- Confirma que el asistente seleccionó la habilidad de base de datos SQL que se pretendía.
- Verifica los nombres del espacio de trabajo, la base de datos, el esquema y los objetos.
- Revisa T-SQL generado para operaciones destructivas, comportamiento de transacciones y alcance de datos.
- Pide un resumen de impacto y un enfoque de retroceso antes de redactar los cambios. Para los cambios de esquema, prepara un script T-SQL de reversión o para deshacer los cambios.
- Ejecuta solo cuando el plan coincida con tu intención.
- Valida el resultado con una consulta de solo lectura separada.
Seguridad y uso responsable
- Las habilidades no omiten la autenticación de Microsoft Entra, los permisos de Fabric, los permisos de SQL ni las políticas organizativas.
- Utiliza siempre identidades de menor privilegio y objetivos separados de desarrollo, prueba y producción.
- No coloques secretos, tokens de acceso ni datos sensibles en las indicaciones ni en los archivos del proyecto.
- Trata SQL generado como código propuesto. Revísalo como cualquier otro cambio en la base de datos.
- Prioriza la detección en modo de solo lectura antes que la escritura o la remediación.
Para más información, consulta Privacidad, seguridad y uso responsable de Copilot por IA en Fabric.