Trabajar con la base de datos Java DB (Derby)

Como se anunció en junio de 2015 , JavaDB ya no se incluye en versiones recientes de JDK.   Se eliminó de JDK 7 y JDK 8 con la actualización del parche crítico del 17 de julio de 2018.   JavaDB fue un cambio de marca de Apache Derby. Los desarrolladores a los que les gusta seguir usando JavaDB deben descargar la última versión de The Apache DB Project .


Trabajar con la base de datos Java DB (Derby)

Este documento muestra cómo configurar una conexión a la base de datos Java DB en NetBeans IDE. Una vez que se establece una conexión, puede comenzar a trabajar con la base de datos en el IDE, lo que le permite crear tablas, llenarlas con datos, ejecutar sentencias y consultas SQL, y más.

La base de datos Java DB es la distribución admitida por Sun de Apache Derby . Java DB es un servidor de base de datos completamente transaccional, seguro y basado en estándares, escrito completamente en Java, y es totalmente compatible con la tecnología SQL, JDBC API y Java EE. La base de datos Java DB se empaqueta con el servidor de aplicaciones GlassFish y también se incluye en JDK 6 . Para obtener más información sobre la base de datos Java DB, consulte la documentación oficial .

Contenido

El contenido de esta página se aplica a NetBeans IDE 7.2, 7.3, 7.4 y 8.0

Para seguir este tutorial, necesita el siguiente software y recursos.

Software o recursoVersión requerida
NetBeans IDE7.2, 7.3, 7.4, 8.0, Java EE
Kit de desarrollo de Java (JDK)Versión 7 u 8
Java DBversión 10.4.x, 10.5.x

Nota.

  • Java DB se instala cuando instala JDK 7 o JDK 8 (excepto en Mac OS X). Si está utilizando Mac OS X, puede descargar e instalar Java DB manualmente o utilizar el Java DB instalado por la versión Java EE del instalador IDE de NetBeans.

Configurando la base de datos

Si tiene el servidor GlassFish registrado en su instalación de NetBeans IDE, Java DB ya estará registrado para usted. Por lo tanto, puede pasar a Iniciar el servidor y Crear una base de datos .

Si descargó el servidor GlassFish por separado y necesita ayuda para registrarlo en NetBeans IDE, consulte Registro de una instancia de servidor GlassFish en los contenidos de ayuda del IDE (F1).

Si acaba de descargar Java DB solo, realice los siguientes pasos.

  1. Ejecute el archivo autoextraíble. Se creará una carpeta llamada 'javadb' en la misma ubicación que el archivo. Si acaba de descargar Java DB y desea que el servidor de la base de datos resida en una ubicación diferente de donde se extrajo, debe reubicarlo ahora.
  2. En su sistema, cree un nuevo directorio para utilizarlo como directorio de inicio para las instancias individuales del servidor de bases de datos. Por ejemplo, puede crear esta carpeta en el directorio raíz de Java DB (javadb) o en cualquier otra ubicación.

Antes de continuar, es importante comprender los componentes que se encuentran en el directorio raíz de Java DB:

  • El subdirectorio de demostración contiene los programas de demostración.
  • El subdirectorio bin contiene los scripts para ejecutar utilidades y configurar el entorno.
  • El subdirectorio javadoc contiene la documentación de la API que se generó a partir de los comentarios del código fuente.
  • El subdirectorio docs contiene la documentación de Java DB.
  • El subdirectorio lib contiene los archivos jar de Java DB.

Registrar la base de datos en NetBeans IDE

Ahora que la base de datos está configurada, realice los siguientes pasos para registrar Java DB en el IDE.

  1. En la ventana Servicios, haga clic con el botón derecho en el nodo Base de datos Java DB y elija Propiedades para abrir el cuadro de diálogo Configuración de Java DB.
  2. Para el campo de texto Instalación de Java DB, ingrese la ruta al directorio raíz de Java DB (javadb) que especificó en el paso anterior.
  3. Para la ubicación de la base de datos, use la ubicación predeterminada si ya se ha proporcionado una ubicación. Haga clic en Aceptar

    Por ejemplo, la ubicación predeterminada podría verse como C: \ Documents and Settings \ username \ .netbeans-derby en una máquina con Windows.

    Diálogo de configuración de Java DB

    Nota. Si el campo Ubicación de la base de datos está vacío, deberá establecer la ruta al directorio que contiene sus bases de datos. Deberá crear un directorio para las bases de datos si no existe ningún directorio.

Inicio del servidor y creación de una base de datos

Las opciones del menú de la Base de datos Java DB se muestran cuando hace clic con el botón derecho en el nodo Java DB en la ventana Servicios. Estos elementos del menú contextual le permiten iniciar y detener el servidor de bases de datos, crear una nueva instancia de base de datos, así como registrar servidores de bases de datos en el IDE (como se demostró en el paso anterior). Para iniciar el servidor de bases de datos:

  1. En la ventana Servicios, haga clic con el botón derecho en el nodo Java DB y elija Iniciar servidor. Tenga en cuenta la siguiente salida en la ventana Salida, que indica que el servidor se ha iniciado:
    Visualización de la ventana de salida después de iniciar el servidor de bases de datos
  2. Haga clic con el botón derecho en el nodo Java DB y elija Crear base de datos para abrir el cuadro de diálogo Crear base de datos Java DB.
  3. Escriba contacto para el Nombre de la base de datos.
  4. Escriba nbuser para el Nombre de usuario y la Contraseña. Haga clic en Aceptar.
    Cuadro de diálogo Crear base de datos Java DB

    Nota. La ubicación de la base de datos es la ubicación predeterminada establecida durante la instalación de Java DB desde GlassFish. Si instaló Java DB por separado, esta ubicación podría ser diferente.

Después de crear la base de datos, si expande el nodo Bases de datos en la ventana Servicios, puede ver que el IDE creó una conexión de base de datos y que la base de datos se agregó a la lista debajo del nodo Java DB.

Conectando a la base de datos

Hasta ahora, ha iniciado con éxito el servidor de bases de datos y ha creado una instancia de base de datos llamada contacto en el IDE. En la ventana Servicios del IDE, puede realizar las siguientes tareas comunes en las estructuras de la base de datos.

  • crear, eliminar, modificar tablas
  • llenar tablas con datos
  • ver datos tabulares
  • ejecución de sentencias y consultas SQL

Para comenzar a trabajar con la base de datos de contactos , debe crear una conexión a ella. Para conectarse a la base de datos de contactos , realice los siguientes pasos.

  1. Expanda el nodo Bases de datos en la ventana Servicios y ubique la nueva base de datos y los nodos de conexión de la base de datos.

    El nodo de conexión de la base de datos ( icono de nodo de conexión) se muestra debajo del nodo Bases de datos. El nombre de la base de datos se muestra debajo del nodo Java DB.

    base de datos de contacto en la ventana Servicios

    Nota. También verá la sample [app on APP]conexión de la base de datos que es el esquema predeterminado de la base de datos.

  2. Haga clic con el botón derecho en el nodo de conexión de la base de datos de contactos ( jdbc: derby: // localhost: 1527 / contact [nbuser en NBUSER] ) y seleccione Conectar.

    El icono del nodo de conexión aparece completo ( icono de nodo de conexión), lo que significa que la conexión se realizó correctamente.
  3. Cree un nombre para mostrar conveniente para la base de datos haciendo clic derecho en el nodo de conexión de la base de datos ( jdbc: derby: // localhost: 1527 / contact [nbuser on NBUSER] ) y seleccionando Cambiar nombre. Escriba Contact DB en el campo de texto y haga clic en Aceptar.

Crear tablas

La base de datos de contactos que acaba de crear está actualmente vacía. Todavía no contiene ninguna tabla o datos. En NetBeans IDE, puede agregar una tabla de base de datos mediante el cuadro de diálogo Crear tabla o ingresando una instrucción SQL y ejecutándola directamente desde el Editor SQL. Puede explorar ambos métodos:

Uso del cuadro de diálogo Crear tabla

  1. Expanda el nodo de conexión Contact DB y tenga en cuenta que hay varios subnodos de esquema. El esquema de la aplicación es el único esquema que se aplica a este tutorial. Haga clic con el botón derecho en el nodo APP y elija Establecer como esquema predeterminado.

  2. Expanda el nodo APP y observe que hay tres subcarpetas: Tablas, Vistas y Procedimientos. Haga clic con el botón derecho en el nodo Tablas y elija Crear tabla para abrir el cuadro de diálogo Crear tabla.
  3. En el campo de texto Nombre de tabla, escriba AMIGOS .
  4. Haga clic en Agregar columna. Aparece el cuadro de diálogo Agregar columna.
  5. Para Nombre de columna, ingrese id . Para Tipo de datos, seleccione INTEGER de la lista desplegable.
  6. En Restricciones, seleccione la casilla de verificación Clave primaria para especificar que esta columna es la clave principal de su tabla. Todas las tablas que se encuentran en las bases de datos relacionales deben contener una clave primaria. Tenga en cuenta que cuando selecciona la casilla de verificación Clave primaria, las casillas Índice y Único también se seleccionan automáticamente y la casilla de verificación Nulo no está seleccionada. Esto se debe a que las claves primarias se usan para identificar una fila única en la base de datos y, de manera predeterminada, se usan como índice de la tabla. Como todas las filas deben identificarse, las claves primarias no pueden contener un valor nulo .
    Agregar columnas a la tabla
  7. Repita este procedimiento ahora especificando campos como se muestra en la tabla a continuación:
  8. LlaveÍndiceNuloÚnicoNombre de columnaTipo de datosTalla
    [comprobado][comprobado][comprobado]carné de identidadENTERO0 0
    [comprobado]nombre de pilaVARCHAR20
    [comprobado]apellidoVARCHAR20
    [comprobado]apodoVARCHAR30
    [comprobado]amigo desdeFECHA0 0
    [comprobado]correo electrónicoVARCHAR60 60

    Está creando una tabla llamada AMIGOS que contiene los siguientes datos para cada registro de contacto:

    • Nombre de pila
    • Apellido
    • Nick Name
    • Amigo desde la fecha
    • Dirección de correo electrónico
    Cuadro de diálogo Crear tabla con campos seleccionados para la tabla de contactos
  9. Cuando esté seguro de que el cuadro de diálogo Crear tabla contiene las mismas especificaciones que las mostradas anteriormente, haga clic en Aceptar. El IDE genera la tabla FRIENDS en la base de datos, y puede ver un nuevo nodo de tabla FRIENDS ( icono de nodo de tabla) debajo del nodo Tablas. Debajo del nodo de la tabla se enumeran las columnas (campos), comenzando con la clave primaria ( icono de nodo de clave principal).

    La tabla AMIGOS se muestra en la ventana Servicios

Usando el Editor SQL:

  1. En la ventana Servicio, haga clic con el botón derecho en el nodo de conexión Contact DB o en el nodo Tablas debajo de él y elija Ejecutar comando. Se abre un lienzo en blanco en el Editor SQL en la ventana principal.
  2. Ingrese la siguiente consulta en el Editor SQL. Esta es una definición de tabla para la tabla COLLEAGUES que está a punto de crear:
    CREAR TABLA "COLEGAS"
        "ID" INTEGER no clave primaria nula,
        "FIRSTNAME" VARCHAR (30),
        "APELLIDO" VARCHAR (30),
        "TITLE" VARCHAR (10),
        "DEPARTAMENTO" VARCHAR (20),
        "EMAIL" VARCHAR (60)
    );

    Nota: Las declaraciones y consultas formadas en el Editor SQL se analizan en lenguaje de consulta estructurado. SQL se adhiere a estrictas reglas de sintaxis con las que debe estar familiarizado cuando trabaje en el editor del IDE. La sintaxis de SQL también puede diferir según el sistema de administración de la base de datos. Consulte el Manual de referencia de JavaDB para obtener pautas específicas.

  3. Haga clic en el ejecutar el botón SQLbotón Ejecutar SQL ( ) en la barra de tareas en la parte superior del editor (Ctrl-Shift-E) para ejecutar la consulta. En la ventana Salida (Ctrl-4), aparece un mensaje que indica que la declaración se ejecutó con éxito.
    La ventana de salida indica ejecución exitosa
  4. Para verificar los cambios, haga clic con el botón derecho en el nodo de conexión Contact DB en la ventana Servicios y elija Actualizar. Esto actualiza el componente Runtime UI al estado actual de la base de datos especificada. Este paso es necesario cuando se ejecutan consultas desde el Editor SQL en NetBeans IDE. Tenga en cuenta que el nuevo nodo de la tabla COLLEAGUES ( icono de nodo de tabla) ahora se muestra en Tablas en la ventana Servicios.

Agregar datos de tabla

Ahora que ha creado una o más tablas en la base de datos de contactos , puede comenzar a llenarla con datos. Hay varias formas de agregar registros a su tabla.

Lea las secciones a continuación para aprender cómo usar todos estos métodos para llenar la tabla AMIGOS con datos.

Ejecutando una instrucción SQL

  1. Expanda las Tablas debajo del nodo Contact DB en la ventana Servicios, haga clic con el botón derecho en la tabla FRIENDS y elija Ejecutar comando para abrir la ventana del Editor SQL.
  2. En el Editor SQL, ingrese la siguiente declaración.
    INSERTE EN LA APLICACIÓN VALORES DE AMIGOS (1, 'Theodore', 'Bagwell', 'T-Bag', '2004-12-25', 'tbag@foxriver.com')

    Mientras escribe, puede usar la finalización del código del Editor SQL.

  3. Haga clic derecho dentro del Editor SQL y elija Ejecutar declaración. La ventana Salida muestra un mensaje que indica que la declaración se ejecutó con éxito.
  4. Para verificar que el nuevo registro se haya agregado a la tabla AMIGOS , haga clic con el botón derecho en el nodo de la tabla AMIGOS en la ventana Servicios y seleccione Ver datos.

    Cuando elige Ver datos, se genera automáticamente una consulta para seleccionar todos los datos de la tabla en el panel superior del Editor SQL. Los resultados de la declaración se muestran en el panel inferior del Editor SQL. En este caso, la tabla AMIGOS se muestra en el panel inferior. Tenga en cuenta que se ha agregado una nueva fila con los datos que acaba de proporcionar de la instrucción SQL.

    nuevo registro agregado a la tabla AMIGOS

Usando el Editor SQL

  1. Haga clic con el botón derecho en el nodo de la tabla AMIGOS y elija Ver datos (si no lo ha hecho en el último paso de la sección anterior).
  2. Haga clic en el botón Insertar registro (s) ( Alt-I ) para agregar una fila.
    Aparece el cuadro de diálogo Insertar registros.
  3. Haga clic en cada celda e ingrese los registros. Tenga en cuenta que para las celdas con el tipo de datos Fecha, puede elegir una fecha del calendario. Haga clic en Aceptar cuando haya terminado.
    nuevos registros agregados a la tabla FRIENDS
    En el Editor SQL, puede ordenar los resultados haciendo clic en el encabezado de una fila, modificar y eliminar registros existentes y ver el script SQL para las acciones que está realizando en el editor (el comando Mostrar script SQL del menú emergente) .

Eliminar tablas

En el siguiente paso, utilizará un script SQL externo para crear una nueva tabla COLLEAGUES . Sin embargo, acaba de crear una tabla COLLEAGUES en la sección Uso del Editor SQL anterior. Para dejar en claro que el script SQL crea una nueva tabla, puede eliminar la tabla COLLEAGUES ya creada ahora. Para eliminar una tabla de base de datos, realice los siguientes pasos.

  1. Expanda el nodo Tablas debajo del nodo de conexión de la base de datos en la ventana Servicios.
  2. Haga clic con el botón derecho en la tabla que desea eliminar y elija Eliminar.

Usar un script SQL externo

La emisión de comandos desde un script SQL externo es una forma popular de administrar su base de datos. Es posible que ya haya creado un script SQL en otro lugar y desee importarlo al IDE de NetBeans para ejecutarlo en una base de datos específica.

En este ejercicio, el script creará una nueva tabla llamada COLLEAGUES y la completará con datos. Realice los siguientes pasos para ejecutar el script en la base de datos de contactos .

  1. Descargue colegas.sql a su sistema local
  2. Elija Archivo> Abrir archivo en el menú principal del IDE. En el explorador de archivos, navegue hasta la ubicación del archivo colegas.sql guardado y haga clic en Abrir. El script se abre automáticamente en el Editor SQL.

    Alternativamente, puede copiar el contenido de colegas.sql y luego abrir el editor de SQL y pegar el contenido del archivo en el editor de SQL.

  3. Asegúrese de que su conexión a Contact DB esté seleccionada en el cuadro desplegable Conexión en la barra de herramientas en la parte superior del editor.
    Cuadro desplegable de conexión en la barra de herramientas del Editor SQL
  4. Haga clic en el ejecutar el botón SQLbotón Ejecutar SQL ( ) en la barra de tareas del Editor SQL. El script se ejecuta contra la base de datos seleccionada, y cualquier comentario se genera en la ventana Salida.
  5. Para verificar los cambios, haga clic con el botón derecho en el nodo de conexión Contact DB en la ventana Servicios y elija Actualizar. Tenga en cuenta que la nueva tabla COLLEAGUES del script SQL ahora se muestra como un nodo de tabla bajo contacto en la ventana Servicios.
  6. Para ver los datos contenidos en las nuevas tablas, haga clic con el botón derecho en la tabla COLLEAGUES y elija Ver datos. De esta manera, también puede comparar los datos tabulares con los datos contenidos en el script SQL para ver si coinciden.

Recreando tablas desde una base de datos diferente

Si tiene una tabla de otra base de datos que le gustaría recrear en la base de datos en la que está trabajando desde NetBeans IDE, el IDE ofrece una herramienta útil para esto. Primero debe tener la segunda base de datos registrada en el IDE, similar a lo que se describió al comienzo de este tutorial. Para los fines de este tutorial, use la base de datos de muestra que viene empaquetada con Java DB. Este proceso se lleva a cabo esencialmente en dos partes: primero 'agarra' la definición de tabla de la tabla seleccionada, luego puede recrear la tabla en la base de datos elegida:

  1. Conéctese a la base de datos de muestra haciendo clic con el botón derecho en el nodo de conexión debajo del nodo Bases de datos en la ventana Servicios y eligiendo Conectar (nombre de usuario y contraseña es la aplicación ).
  2. Expanda el nodo Tablas debajo de la conexión de la base de datos de muestra , haga clic con el botón derecho en el nodo de la tabla CLIENTE y elija Grab Structure.

    Elemento de menú Grab Structure que se muestra en la ventana Servicios
  3. En el cuadro de diálogo Grab Table que se abre, especifique una ubicación en su computadora para guardar el archivo grab que se creará. Clic en Guardar.

    El archivo grab registra la definición de tabla de la tabla seleccionada.

  4. Expanda el nodo del esquema APP debajo de la conexión de la base de datos Contact DB , haga clic con el botón derecho en el nodo Tablas y elija Recrear tabla para abrir el cuadro de diálogo Recrear tabla.
  5. En el cuadro de diálogo Recreate Table, navegue hasta la ubicación donde guardó el archivo de captura CLIENTE y haga clic en Abrir para abrir el cuadro de diálogo Name the Table.

    Asigne un nombre al cuadro de diálogo Tabla que contiene la definición de tabla para CLIENTE
  6. En este punto, puede cambiar el nombre de la tabla o editar la definición de la tabla. De lo contrario, haga clic en Aceptar para crear inmediatamente la tabla en la base de datos de contactos . Aparece un nuevo nodo de tabla CLIENTE debajo del nodo de conexión Contact DB.

    nuevo nodo de tabla CLIENTE mostrado en la ventana Servicios

Si ve los datos en la nueva tabla CLIENTE , verá que no hay registros en la base de datos, pero que la estructura de la tabla es idéntica a la tabla que tomó.

Comentarios

Entradas populares de este blog

Del modelo conceptual al modelo relacional

Cómo crear una aplicación Java para gestión de base de datos (Parte 1)