Resumen de la API de base de datos

La API de base de datos de Drupal 8 proporciona un nivel estándar y independiente del proveedor para acceder a los servidores de bases de datos. Casi nunca debe realizar llamadas directas a la base de datos, a menos que esté desarrollando APIs centrales.

La API está diseñada para preservar al máximo la sintaxis y el poder del SQL, pero también:

• Facilita el soporte para múltiples servidores de bases de datos;
• Permite a los desarrolladores usar funciones más complejas como transacciones;
• Proporciona una interfaz estructurada para la construcción dinámica de consultas;
• Garantiza la validación de seguridad y otras mejores prácticas;
• Ofrece a los módulos una interfaz limpia para interceptar y alterar las consultas del sitio.

La documentación principal de la API de base de datos se obtiene directamente de los comentarios en el código. Esta sección del manual complementa esos documentos API, proporcionando un tutorial para los autores de módulos que desean interactuar con el sistema de base de datos, así como una visión general del sistema desde la perspectiva del administrador.

La API de base de datos fue construida usando conceptos de diseño orientado a objetos, por lo que este documento asume al menos un conocimiento parcial de estos conceptos. También existen estilos procedurales disponibles para las operaciones comunes, pero estos estilos no son recomendados. Se recomienda usar el objeto de conexión para interactuar con la base de datos.

Nota que la API de base de datos no siempre es la mejor opción para interactuar con datos. El uso de la API en Drupal 8 suele ser situacional, por ejemplo, usar la Node API para operaciones CRUD de nodos, la Entity API para crear entidades, etc. Por favor, revise la documentación de las APIs para determinar cuál se adapta mejor a sus necesidades.

Nota: este manual puede no cubrir todas las funcionalidades de la API.