Documentación de Oracle Cloud Infrastructure

Uso del plugin IntelliJ para desarrollo

Examine las tablas y ejecute consultas en la instancia de Oracle NoSQL Database Cloud Service o simulador desde IntelliJ.

El plugin de IntelliJ de Oracle NoSQL Database Cloud Service se conecta a una instancia en ejecución de Oracle NoSQL Database Cloud Service o simulador y le permite:
  • Empezar rápidamente a usar Oracle NoSQL Database Cloud Service mediante los ejemplos disponibles con el plugin.
  • Ver tablas en su simulador o cuenta en la nube.
  • Recuperar columnas, índices, claves primarias y claves de partición horizontal para cada tabla.
  • Crear y probar las consultas SQL en una tabla y obtener resultados en formato tabular.
  • Ver los datos en cada columna en el formato JSON.

En este artículo se incluyen los siguientes temas:

Configuración del plugin de IntelliJ

Descubra cómo configurar el plugin de IntelliJ para la instancia o el simulador de Oracle NoSQL Database Cloud Service.

Lleve cabo los siguientes pasos:
  1. Descargue e inicie Oracle NoSQL Database Cloud Simulator. Consulte Descarga de Oracle NoSQL Database Cloud Simulator.
  2. Descargue y extraiga Oracle NoSQL Database Java SDK. Consulte Acerca de los controladores de Oracle NoSQL Database SDK.
  3. Instale el plugin de IntelliJ y reinicie el IDE.
    Tiene dos opciones para instalar el plugin:

    Consejo:

    No extraiga el archivo zip del plugin descargado. Seleccione el plugin en el formato zip al instalarlo desde el disco.
Después de configurar correctamente el plugin de IntelliJ, cree un proyecto de NoSQL y conéctelo a su instancia de Oracle NoSQL Database Cloud Service o simulador.

Creación de un proyecto de NoSQL en IntelliJ

Aprenda a crear un proyecto de NoSQL en IntelliJ.

Lleve cabo los siguientes pasos:
  1. Abra IntelliJ IDEA. Haga clic en Archivo > Nuevo > Proyecto.
  2. Seleccione ejemplos de Oracle NoSQL de la ventana del explorador y haga clic en Siguiente.
  3. Acceda a la ubicación donde extrajo Oracle NoSQL Database Java SDK en su disco duro y haga clic en Aceptar.
    Por ejemplo, si extrajo Oracle NoSQL Database Java SDK en la unidad D:\, la ruta se parecerá a D:\oracle-nosql-java-sdk-5.2.11
  4. Haga clic en Siguiente.
  5. Introduzca un valor en Nombre de proyecto y Ubicación del proyecto y haga clic en Terminar.
  6. Una vez creado el proyecto de NoSQL, puede examinar los archivos java de ejemplo desde la ventana Explorador de proyectos.
Después de crear correctamente un proyecto de NoSQL en IntelliJ, conecte su proyecto a su Oracle NoSQL Database Cloud Service o simulador.

Conexión a Oracle NoSQL Database Cloud Service desde IntelliJ

Aprenda a conectar el proyecto de NoSQL a Oracle NoSQL Database Cloud Service mediante el plugin de IntelliJ

Lleve cabo los siguientes pasos:
  1. Abra el proyecto de NoSQL en IntelliJ.
  2. Haga clic en el icono Icono de configuración de la ventana Explorador de esquemas para abrir el cuadro de diálogo Configuración para el plugin.
  3. Amplíe Herramientas > Oracle NoSQL en el explorador de configuración y haga clic en Conexiones.
  4. Seleccione Cloud en el menú desplegable para el tipo de conexión.
  5. Introduzca valores para los siguientes parámetros de conexión y haga clic en Aceptar.

    Tabla 5-1 Parámetros de conexión

    Parámetro Descripción Valor de ejemplo
    Punto final Punto de acceso a la red regional a Oracle NoSQL Database Cloud Service. https://nosql.us-ashburn-1.oci.oraclecloud.com (para el identificador de región de Oracle NoSQL Database Cloud Service de Ashburn en la región Norteamérica. Consulte Regiones de datos y puntos finales de servicio asociados para obtener una lista de puntos finales de servicio.
    Ruta de SDK Ruta completa al directorio en el que extrajo Oracle NoSQL Database Java SDK. D:\oracle-nosql-java-sdk-5.2.11
    ID de cliente e ID de usuario OCID de arrendamiento y OCID de usuario para Oracle NoSQL Database Cloud Service. Consulte Dónde obtener el OCID del arrendamiento y el OCID del usuario en la documentación de Oracle Cloud Infrastructure.
    Huella y frase de contraseña (opcional) Huella y contraseña de la clave de firma creada al generar y cargar la clave de firma de API.
    Consulte los siguientes recursos en la documentación de Oracle Cloud Infrastructure:
    Clave privada Clave privada generada para el usuario. Para el usuario de la aplicación, se debe generar y cargar una clave de firma de API. Consulte Cómo generar una clave de firma de API para generar la clave de firma con una contraseña opcional.
    Compartimento (opcional) ID de compartimento para el esquema de base de datos de NoSQL. Si no se especifica ningún valor, se define por defecto en el compartimento raíz.
  6. El plugin de IntelliJ conecta el proyecto a Oracle NoSQL Database Cloud Service y muestra su esquema en la ventana Explorador de esquemas.
  7. Si es necesario, puede cambiar el punto final o compartimento del servicio desde la propia ventana del Explorador de esquemas. Para ello, haga clic en el icono Icono Más Opciones en la ventana Explorador de esquemas.
    Aparece una ventana de diálogo donde puede proporcionar los nuevos valores para el punto final y el compartimento. Introduzca los valores que desea modificar y haga clic en Aceptar.
    Puede proporcionar valores para:
    • Punto final y compartimento, o
    • Punto final solo. En este caso, el compartimento se define por defecto en el compartimento raíz de esa región.
Después de conectar correctamente el proyecto a Oracle NoSQL Database Cloud Service, puede gestionar las tablas y los datos del esquema.

Conexión a Oracle NoSQL Database Cloud Simulator desde IntelliJ

Descubra cómo conectar su proyecto de NoSQL a Oracle NoSQL Database Cloud Simulator mediante el plugin de IntelliJ.

Lleve cabo los siguientes pasos:
  1. Abra el proyecto de NoSQL en IntelliJ.
  2. Haga clic en el icono Icono de configuración de la ventana Explorador de esquemas para abrir el cuadro de diálogo Configuración para el plugin.
  3. Amplíe Herramientas > Oracle NoSQL en el explorador de configuración y haga clic en Conexiones.
  4. Seleccione Cloudsim en el menú desplegable para el tipo de conexión.
  5. Introduzca valores para los siguientes parámetros de conexión y haga clic en Aceptar.

    Tabla 5-2 Parámetros de conexión

    Parámetro Descripción Valor de ejemplo
    URL del servicio La dirección IP y el puerto en el que se ejecuta Oracle NoSQL Database Cloud Simulator. El valor por defecto es http://localhost:8080
    Identificador del inquilino Identificador único para identificar al inquilino. El valor por defecto es exampleId. Conserve este valor si desea probar los ejemplos.
    Ruta de SDK Ruta completa al directorio en el que extrajo Oracle NoSQL Database Java SDK. D:\oracle-nosql-java-sdk-5.2.11
  6. El plugin de Intellij conecta el proyecto a Oracle NoSQL Database Cloud Simulator y muestra su esquema en la ventana Explorador de esquemas.
    Nota

    Antes de conectar su proyecto a Oracle NoSQL Database Cloud Simulator, se debe iniciar y ejecutar. De lo contrario, la solicitud de conexión fallará en IntelliJ.
Después de conectar correctamente el proyecto a Oracle NoSQL Database Cloud Simulator, puede gestionar las tablas y los datos del esquema.

Gestión de tablas mediante el plugin de IntelliJ

Aprenda a crear tablas y ver datos de tablas en Oracle NoSQL Database Cloud Service o en Oracle NoSQL Database Cloud Simulator desde IntelliJ.

Después de conectarse a Oracle NoSQL Database Cloud Simulator u Oracle NoSQL Database Cloud Service, puede ejecutar los ejemplos descargados con Oracle NoSQL Database Java SDK para crear una tabla de ejemplo. Con la ayuda del plugin de IntelliJ, puede ver las tablas y sus datos en la ventana Explorador de esquemas.
Para ejecutar un programa de ejemplo:
  1. Abra el proyecto de NoSQL conectado a su Oracle NoSQL Database Cloud Service o simulador.
  2. Busque y haga clic en BasicTableExample en la ventana Explorador de proyectos. Al observar el código, puede observar que este programa crea una tabla denominada audienceData, coloca dos filas en esta tabla, consulta las filas insertadas, suprime las filas insertadas y, finalmente, borra la tabla audienceData.
  3. Para transferir los argumentos necesarios, haga clic en Ejecutar > Editar configuraciones. Según el tipo de conexión, introduzca los siguientes argumentos de programa y haga clic en Aceptar.

    Tabla 5- 3 Argumentos de programa

    Tipo de conexión Argumentos de programa Más información
    Cloudsim http://localhost:8080 Si inició Oracle NoSQL Database Cloud Simulator en un puerto diferente, debe reemplazar 8080 por ese número de puerto.
    Cloud us-ashburn-1 -configFile D:\OCI_PROP\config El primer argumento indica la región de datos de Oracle NoSQL Database Cloud Service. El segundo argumento transfiere un archivo de configuración que contiene las credenciales para conectarse a Oracle NoSQL Database Cloud Service.
  4. Para ejecutar este programa, haga clic en Ejecutar > Ejecutar "BasicExampleTable" o pulse Mayús + 10.
  5. Verifique los logs del terminal para confirmar que el código se ha ejecutado correctamente. Puede ver los mensajes de visualización que indican la creación de tablas, la inserción de filas, etc.

    Consejo:

    Como BasicExampleTable suprime las filas insertadas y borra la tabla audienceData, no puede ver esta tabla en el Explorador de esquemas. Si desea ver la tabla en el Explorador de esquemas, introduzca un comentario en el código que suprime las filas insertadas y borra la tabla, y vuelva a ejecutar el programa.
  6. Para ver las tablas y sus datos:
    1. Localice el Explorador de esquemas y haga clic en el icono Icono de Refrescar para volver a cargar el esquema.
    2. Localice la tabla audienceData en el identificador de inquilino y amplíela para ver sus columnas, la clave primaria y los detalles de la clave de partición.
    3. Haga doble clic en el nombre de tabla para ver sus datos. También puede hacer clic con el botón derecho del ratón en la tabla y seleccionar Examinar tabla.
    4. Aparece una ventana del visor de registros en el editor principal. Haga clic en Ejecutar para ejecutar la consulta y mostrar los datos de la tabla.
      Nota

      A partir de la versión actual, solo se admiten las consultas SELECT en las tablas NoSQL desde el Explorador de esquemas.
    5. Para ver datos de celdas individuales por separado, haga doble clic en la celda.