Uso del plugin de IntelliJ para desarrollo
Examine las tablas y ejecute consultas en la instancia de Oracle NoSQL Database Cloud Service o en el simulador de Oracle NoSQL Database Cloud desde IntelliJ
El complemento de IntelliJ de Oracle NoSQL Database Cloud Service se conecta a una instancia en ejecución de Oracle NoSQL Database Cloud Service u Oracle NoSQL Database Cloud Simulator y le permite:
-
Vea las tablas en una estructura de árbol bien definida con el Explorador de tablas.
-
Ver información sobre columnas, índices, claves primarias y claves de partición horizontal de una tabla.
-
Ver datos de columna en una estructura JSON con formato correcto.
-
Cree tablas mediante la entrada de esquema basada en formularios o proporcione sentencias DDL.
-
Borrar tablas.
-
Agregue nuevas columnas mediante la entrada basada en formularios o proporcione sentencias DDL.
-
Borrar columnas.
-
Crear índices.
-
Borrar índices.
-
Ejecutar consultas SELECT SQL en una tabla y ver los resultados de las consultas en formato tabular.
-
Ejecutar sentencias DML para actualizar, insertar y suprimir datos de una tabla.
En este artículo se incluyen los siguientes temas:
Configuración del plugin de IntelliJ
Descubra cómo configurar el plugin de IntelliJ para el simulador de Oracle NoSQL Database Cloud Service o de Oracle NoSQL Database Cloud.
Requisito:
Instale IntelliJ IDEA. Puede descargar IntelliJ IDEA desde JetBrains.
Procedimiento:
Puede instalar el complemento de la siguiente manera:
-
Abra la página Oracle NoSQL DatabaseConnector, Repositorio de plugin de JetBrains.
- Seleccione Obtener.
- En el menú Versiones, seleccione Descargar para la última versión de Oracle NoSQL Database Connector.
- En la ventana emergente, siga las instrucciones de la pantalla en How to Install 'Oracle NoSQL Database Connector'.
Reinicie el IDE. Verá el icono Explorador de esquemas en el panel derecho.
Después de configurar correctamente el complemento de IntelliJ, cree un proyecto NoSQL y conéctelo a su instancia o simulador de Oracle NoSQL Database Cloud Service o Oracle NoSQL Database Cloud.
Creación de un proyecto de NoSQL en IntelliJ
Aprenda a crear un proyecto de NoSQL en IntelliJ.
Realice los siguientes pasos:
- Abra IntelliJ IDEA. Haga clic en Archivo > Nuevo > Proyecto.
- Introduzca un valor en Nombre del proyecto y Ubicación de proyecto. Seleccione Crear.
- Seleccione un sistema de compilación y una ruta de JDK.
- IntelliJ crea el directorio del proyecto NoSQL, que incluye un archivo Java de ejemplo. Si ha seleccionado Maven como sistema de compilación, el directorio del proyecto también incluye un archivo pom.xml.
- Asegúrese de que el servicio de notificaciones está activado para el proyecto de Oracle NoSQL. Para activar las notificaciones, pulse
Alt+\para abrir el menú principal. Haga clic en Ver, amplíe Ventanas de herramientas > Notificaciones. Aparece un icono de notificación
en la barra de la ventana de herramientas derecha.
Una vez que haya creado correctamente un proyecto NoSQL en IntelliJ, puede conectar el proyecto a Oracle NoSQL Database Cloud Service u Oracle NoSQL Database Cloud Simulator.
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
Realice los siguientes pasos:
-
Abra el proyecto de NoSQL en IntelliJ.
-
Haga clic sobre el icono de tarea
de la ventana Explorador de Esquemas para abrir el recuadro de diálogo Configuración para el plugin. -
Amplíe Herramientas > Oracle NoSQL en el explorador de valores y haga clic enConexiones.
-
Seleccione Cloud en el menú desplegable para el tipo de perfil. Puede ver todas las conexiones existentes para el tipo de perfil de nube en la lista desplegable Conexiones.
-
Haga clic en Add Connection (Agregar Conexión). Tiene dos opciones para crear una conexión.
-
Uso del archivo de configuración: especifique la ruta de acceso del archivo de configuración, que apunta a la ubicación del archivo de configuración de OCI almacenado en el sistema local. Este archivo contiene los parámetros esenciales necesarios para conectarse a Oracle NoSQL Database Cloud Service, como la región, el ID de inquilino, el ID de usuario, la huella, la frase de contraseña y la ruta de clave privada.
Introduzca los valores necesarios para los siguientes parámetros de conexión y seleccione Agregar. A continuación, seleccione OK (Aceptar).
Tabla: Opción de Archivo de Configuración de Parámetros de Conexión
parámetro Descripción Valor de ejemplo Nombre de conexión Un nombre único, que se asigna a una especificación de conexión específica, es obligatorio a partir de la versión 1.5.1 del plugin. Se recomienda actualizar el campo Nombre de conexión después de actualizar el plugin de la versión 1.4.0 o inferior.
Nota: puede agregar varias conexiones y las especificaciones de conexión almacenadas son persistentes.ndcs_con1Archivo de Configuración Ruta de acceso de un directorio donde el archivo de configuración se almacena en el sistema local. Para obtener más información sobre el archivo de configuración y su contenido, consulte el método Principales de usuario en Autenticación para conectarse a Oracle NoSQL Database. ~/.oci/configPerfil Nombre del perfil.
Nota: puede crear varios perfiles con distintos valores para estas entradas y, a continuación, puede especificar el perfil que desea cargar.DEFAULTCompartimento (opcional) OCID/nombre de compartimento para el esquema de base de datos NoSQL.
Nota: al especificar el nombre del compartimento, debe especificar toda la jerarquía con dos puntos que separen cada entrada.developers:dev1.Aquí
dev1es un compartimento en el compartimentodevelopers.
Nota: si no se especifica ningún valor, se define por defecto en el compartimento raíz.El plugin se conecta a la región especificada en el archivo de configuración.
Si utiliza la autenticación basada en token de sesión, el archivo de configuración incluye el perfil designado para el token de sesión junto con la ruta de token. Para conectarse a Oracle NoSQL Database Cloud Service, debe seleccionar la opción de archivo de configuración y especificar el perfil adecuado.
-
Avanzado: especifique directamente los parámetros de conexión necesarios para conectarse a Oracle NoSQL Database Cloud Service. Introduzca los valores necesarios para los siguientes parámetros y seleccione Agregar. A continuación, seleccione OK (Aceptar).
Tabla - Opción Avanzada de Parámetros de Conexión
parámetro Descripción Valor de ejemplo Nombre de conexión Un nombre único, que se asigna a una especificación de conexión específica, es obligatorio a partir de la versión 1.5.1 del plugin. Se recomienda actualizar el campo Nombre de conexión después de actualizar el plugin de la versión 1.4.0 o inferior.
Nota: Puede agregar varias conexiones y las especificaciones de conexión almacenadas son persistentes.ndcs_con1Punto Final El punto de acceso a la red local a Oracle NoSQL Database Cloud Service. https://nosql.us-ashburn-1.oci.oraclecloud.com(para el identificador del área de Oracle NoSQL Database Cloud Service de Ashburn en la zona de Norteamérica. Consulte Regiones de datos y puntos finales de servicio asociados para obtener una lista de puntos finales de servicio.ID de inquilino 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:
- Para generar la clave de firma con una frase de contraseña opcional, consulte Cómo generar una clave de firma de API.
- Para obtener la huella de la clave, consulte Cómo obtener la huella de la clave.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) OCID/nombre de compartimento para el esquema de base de datos NoSQL.
Nota: Al especificar el nombre del compartimento, debe especificar toda la jerarquía con dos puntos que separen cada entrada.developers:dev1.Aquí
dev1es un compartimento en el compartimentodevelopers.
Nota: si no se especifica un valor, se define por defecto en el compartimento raíz.Nota:
-
A partir de la versión 1.5.4, el plugin IntelliJ descarga automáticamente el SDK de Java Oracle NoSQL más reciente y define la ruta de acceso del SDK al crear una conexión.
-
Si está actualizando el plugin de la versión 1.4.0 o inferior, todas las conexiones almacenadas se migran a la nueva versión. En este caso, el nombre de conexión será el mismo que el punto final. Siga el siguiente paso para cambiar el nombre de conexión.
-
-
El plugin IntelliJ guarda los detalles de conexión en el nombre de conexión especificado. Para modificar los detalles de conexión, seleccione el nombre de conexión en la lista desplegable de Conexiones. Haga clic en Modificar conexión. Puede cambiar cualquiera de los parámetros de conexión (mencionados anteriormente) y hacer clic en Aceptar para guardar la configuración. Para eliminar un nombre de conexión del plugin, seleccione el nombre de conexión y haga clic en Suprimir conexión. Una vez que confirme la acción que desea suprimir, el nombre de conexión se elimina del plugin.
-
Haga clic en el icono Web en el Explorador de Esquemas. La lista de conexiones existentes se muestra en el cuadro desplegable. El nombre de conexión se visualizará en la ventana de la herramienta NoSQL con el siguiente formato:
Tabla - Visualización de conexión
Opción que se usa para crear una conexión Mostrar en la ventana de herramientas NoSQL AdvancedConnection Name:Endpoint:Compartment Name/OCID(si no es root)Use Configuration FileConnection Name:Configuration file path:Profile:Compartment Name/OCID(si no es root)Seleccione la conexión y haga clic en Aceptar. El complemento de IntelliJ conecta su proyecto a Oracle NoSQL Database Cloud Service y muestra su esquema en la ventana Explorador de esquemas.
Después de conectar correctamente el proyecto a Oracle NoSQL Database Cloud Service, puede gestionar las tablas y los datos de su esquema.
Conexión al Simulador de Oracle NoSQL Database Cloud desde IntelliJ
Descubra cómo conectar su proyecto de NoSQL a Oracle NoSQL Database Cloud Simulator mediante el plugin de IntelliJ.
Realice los siguientes pasos:
-
Descargue e inicie Oracle NoSQL Database Cloud Simulator. Consulte Descarga de Oracle NoSQL Database Cloud Simulator.
-
Abra el proyecto de NoSQL en IntelliJ.
-
Haga clic sobre el icono de tarea
de la ventana Explorador de Esquemas para abrir el recuadro de diálogo Configuración para el plugin. -
Amplíe Herramientas > Oracle NoSQL en el explorador de valores y haga clic enConexiones. Puede ver todas las conexiones existentes para el tipo de perfil Cloudsim en la lista desplegable Conexiones.
-
Seleccione Cloudsim en el menú desplegable para el tipo de perfil.
-
Haga clic en Add Connection (Agregar Conexión). Introduzca valores para los siguientes parámetros de conexión y haga clic en Aceptar.
Tabla - Parámetros de conexión
parámetro Descripción Valor de ejemplo Nombre de conexión Un nombre único, que se asigna a una especificación de conexión específica, es obligatorio a partir de la versión 1.5.1 del plugin. Se recomienda actualizar el campo Nombre de conexión después de actualizar el plugin de la versión 1.4.0 o inferior.
Nota: Puede agregar varias conexiones y las especificaciones de conexión almacenadas son persistentes.nosql_sim1URL de Servicio Dirección IP y puerto en el que se ejecuta Oracle NoSQL Database Cloud Simulator. El valor por defecto es http://localhost:8080Identificador de inquilino Identificador único para identificar al inquilino. El valor predeterminado es exampleId. Conserve este valor si desea probar los ejemplos. Nota:
-
A partir de la versión 1.5.4, el plugin IntelliJ descarga automáticamente el último SDK de Java NoSQL y define la ruta de acceso del SDK al crear una conexión.
-
Si está actualizando el plugin de la versión 1.4.0 o inferior, todas las conexiones almacenadas se migran a la nueva versión. En este caso, el nombre de conexión será el mismo que el punto final. Siga el siguiente paso para cambiar el nombre de conexión.
-
-
El plugin IntelliJ guarda los detalles de conexión en el nombre de conexión especificado. Para modificar los detalles de conexión, seleccione el nombre de conexión en la lista desplegable de Conexiones. Haga clic en Modificar conexión. Puede cambiar cualquiera de los parámetros de conexión (mencionados anteriormente) y hacer clic en Aceptar para guardar la configuración. Para eliminar un nombre de conexión del plugin, seleccione el nombre de conexión y haga clic en Suprimir conexión. Una vez que confirme la acción que desea suprimir, el nombre de conexión se elimina del plugin.
-
Haga clic en el icono Web en el Explorador de Esquemas. La lista de conexiones existentes se muestra en el cuadro desplegable. El nombre de conexión se visualizará en la ventana de la herramienta NoSQL con el siguiente formato:
Connection Name:service Url : Tenant IdentifierSeleccione la conexión y haga clic en Aceptar. The IntelliJ plugin connects your project to the Oracle NoSQL Database Cloud Simulator and displays its schema in the Schema Explorer window.
Nota: Antes de conectar su proyecto al simulador de Oracle NoSQL Database Cloud, se debe iniciar y ejecutar. De lo contrario, la solicitud de conexión fallará en IntelliJ.
Después de conectar correctamente el proyecto al simulador de Oracle NoSQL Database Cloud, puede gestionar las tablas y los datos de su esquema.
Creación de aplicaciones mediante el SDK de Java de Oracle NoSQL desde IntelliJ
Descubra cómo crear aplicaciones a partir del plugin de IntelliJ mediante el paquete Oracle NoSQL Java SDK.
Después de conectarse a Oracle NoSQL Database Cloud Simulator u Oracle NoSQL Database Cloud Service, puede crear aplicaciones mediante el SDK de Java de Oracle NoSQL.
En este tema, ejecutará una aplicación de ejemplo disponible en el paquete Oracle NoSQL Java SDK para crear una tabla en Oracle NoSQL Database Cloud Simulator u Oracle NoSQL Database Cloud Service.
Realice los siguientes pasos:
-
Descargue el SDK de Java de Oracle NoSQL Database más reciente desde GitHub.
-
Extraiga (descomprima) el archivo descargado en un repositorio local.
-
Inicie IntelliJ IDEA y abra su proyecto NoSQL.
-
Si utiliza el sistema de creación de Maven, asegúrese de que ha agregado las dependencias necesarias en pom.xml. Para obtener más información, consulte Oracle NoSQL Java SDK GitHub.
-
En el directorio extraído del SDK de Java de Oracle NoSQL Database Cloud Service, vaya a la carpeta
oracle-nosql-java-sdk > examples. Copie los archivos javaBasicTableExampleyCommonen el directorio del proyecto NoSQL.El programa
BasicExampleTablecrea una tabla denominadaaudienceData, agrega dos filas en esta tabla, consulta las filas insertadas, suprime las filas insertadas y, finalmente, borra la tablaaudienceData. -
Antes de ejecutar el programa de aplicación, debe proporcionar los argumentos necesarios para conectarse:
a. En el menú, seleccione Run (Ejecutar) > Edit Configurations (Editar configuraciones).
b. Seleccione Agregar nueva configuración y, a continuación, seleccione Aplicación.
c. En la ventana que aparece a la derecha, introduzca la clase principal en el campo Nombre.
d. En Crear y ejecutar, especifique la ruta de JDK de Java e introduzca la clase main.
e. Introduzca los argumentos de programa necesarios. Seleccione Aplicar y, a continuación, seleccione Aceptar.
Tabla - Argumentos de programa
Tipo de conexión Argumentos del Programa Más información Simultaneidad http://localhost:8080Si inició Oracle NoSQL Database Cloud Simulator en un puerto diferente, debe reemplazar 8080 por ese número de puerto. Nube Region [-configFile <path-to-config-file>]
Por ejemplo:us-ashburn-1 -configFile D:\OCI_PROP\configEl primer argumento indica la región de datos de Oracle NoSQL Database Cloud Service. El segundo argumento transfiere un archivo que contiene las credenciales para conectarse a Oracle NoSQL Database Cloud Service. Para obtener información sobre el contenido del archivo de configuración, consulte Autenticación para conectarse a Oracle NoSQL Database.
Si no especifica el archivoconfig, la secuencia de comandos utiliza el constructor predeterminado para la claseSignatureProvider, que busca el archivoconfigen:$HOME/.oci -
Para ejecutar este programa, seleccione Ejecutar o pulse Mayús + 10.
Nota: Si desea ejecutar el programa desde un terminal, utilice los siguientes comandos de ejemplo:
Compile el programa utilizando el sistema maven build utilizando:
mvn compileEjecute el programa proporcionando los argumentos del programa:
mvn exec:java -Dexec.mainClass=BasicTableExample -Dexec.args="<region>"Ejemplo:
mvn exec:java -Dexec.mainClass=BasicTableExample -Dexec.args="us-ashburn-1" -
Vea la salida en la ventana Ejecutar herramienta en la parte inferior. Verifique los logs para confirmar que la ejecución del código se ha realizado correctamente. Puede ver los mensajes de visualización que indican la creación de tablas, la inserción de filas, etc.
Salida de ejemplo:
Creating table audienceData
Created table audienceData
Put row: {"cookie_id":123,"audience_data":{"audience_segment":{"sports_lover":"2018-11-30","book_reader":"2018-12-01"},"ipaddr":"10.0.00.xxx"}} result=non-null Version
Got row: {"cookie_id":123,"audience_data":{"audience_segment":{"sports_lover":"2018-11-30","book_reader":"2018-12-01"},"ipaddr":"10.0.00.xxx"}}
Inserted row via query, result:
{"NumRowsInserted":1}
Got row inserted by query: {"cookie_id":106,"audience_data":{"audience_segment":{"foodie":"2020-06-01","sports_lover":"2020-05-10"},"ipaddr":"10.0.00.xxx"}}
Put row from json: {"cookie_id":456,"audience_data":{"ipaddr":"10.0.00.yyy","audience_segment":{"sports_lover":"2019-01-05","foodie":"2018-12-31"}}}
Got row inserted as JSON: {"cookie_id":456,"audience_data":{"audience_segment":{"sports_lover":"2019-01-05","foodie":"2018-12-31"},"ipaddr":"10.0.00.yyy"}}
Query results for SELECT * from audienceData WHERE cookie_id = 456:
{"cookie_id":456,"audience_data":{"audience_segment":{"foodie":"2018-12-31","sports_lover":"2019-01-05"},"ipaddr":"10.0.00.yyy"}}
Deleted key {"cookie_id":456} result=true
Dropping table audienceData
Process finished with exit code 0
Nota: 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 para el código que suprime las filas insertadas y borra la tabla, y vuelva a ejecutarse el programa.
Gestión de tablas mediante el plugin de IntelliJ
Aprenda a crear tablas y ver datos de tabla en Oracle NoSQL Database Cloud Service u Oracle NoSQL Database Cloud Simulator desde el Explorador de esquemas.
Realice los siguientes pasos:
-
Localice el Explorador de esquemas y haga clic en el icono
para volver a cargar el esquema. -
Localice la tabla con el identificador de inquilino y amplíela para ver sus columnas, la clave primaria y los detalles de clave partición horizontal. Si ha creado una aplicación de ejemplo como se describe en el tema Creación de aplicaciones mediante Oracle NoSQL Java SDK desde IntelliJ, podrá ver la tabla
audienceData. -
Haga doble clic en el nombre de tabla para ver sus datos. También puede hacer clic con el botón derecho del mouse en la tabla y seleccionar Examinar tabla.
-
Aparece una ventana del visor de registros en el editor principal. Haga clic en Ejecutar para ejecutar la consulta y mostrar la tabla de datos.
-
Para ver datos de celdas individuales por separado, haga doble clic en la celda.
Realizar operaciones DDL con IntelliJ
Puede utilizar IntelliJ para realizar operaciones DDL.
Algunas de las operaciones DDL que se pueden realizar desde el plugin IntelliJ son:
CREATE TABLE
-
Localice el Explorador de esquemas y haga clic en el icono Refrescar para volver a cargar el esquema.
-
Haga clic con el botón derecho en el nombre de la conexión y seleccione Crear Tabla.
-
En la lista de valores, introduzca los detalles de la nueva tabla. Puede crear la tabla de Oracle NoSQL Database en dos modos:
-
Entrada DDL Simple: puede utilizar este modo para crear la tabla de forma declarativa, es decir, sin escribir una sentencia DDL.
-
Entrada de DDL avanzada: puede utilizar este modo para crear la tabla mediante una sentencia DDL.
-
-
Tiene la opción de ver la sentencia DDL antes de crearla. Haga clic en Mostrar DDL para ver la sentencia DDL formada en función de los valores introducidos en los campos en el modo de entrada DDL simple. Esta sentencia DDL se ejecuta al hacer clic en Create.
-
Haga clic en Crear para crear la tabla.
-
Para crear una tabla secundaria, haga clic con el botón derecho en la tabla deseada y seleccione Crear Tabla Secundaria. Puede crear una tabla secundaria en dos modos:
-
Entrada DDL Simple: Puede utilizar este modo para crear una tabla secundaria simplemente introduciendo un nombre de tabla junto con otros detalles necesarios.
-
Entrada de DDL avanzada: puede utilizar este modo para crear una tabla secundaria mediante una sentencia DDL.
Para obtener más información sobre las tablas secundarias, consulte Jerarquías de Tabla.
-
-
Haga clic en Crear para crear una tabla secundaria.
-
Tiene la opción de ver la sentencia DDL después de crear una tabla. Haga clic con el botón derecho en la tabla existente. Seleccione Ver DDL de Tabla. Para copiar la sentencia DDL, haga clic en Copiar en Portapapeles. Haga clic en Aceptar para cerrar el recuadro de diálogo.
DROP TABLE
-
Localice el Explorador de esquemas y haga clic en el icono Refresh para volver a cargar el esquema.
-
Haga clic con el botón derecho en la tabla que desea borrar. Seleccione Borrar tabla.
-
Aparece una ventana de confirmación, haga clic en Aceptar para confirmar la acción de borrado.
CREATE INDEX
-
Localice el Explorador de esquemas y haga clic en el icono Refresh para volver a cargar el esquema.
-
Haga clic con el botón derecho en la tabla en la que se debe crear el índice. Seleccione Crear Índice.
-
En el panel Crear índice, tiene la opción de crear un índice en dos modos:
-
Creación de Índices Basados en Pantalla (Entrada DDL Simple): Introduzca los detalles para crear un índice sin escribir ninguna sentencia DDL. Especifique el nombre del índice y las columnas que formarán parte del índice. Si la columna es de tipo de dato JSON, verá aparecer un campo adicional denominado "
JSON Path to Index Field". Introduzca la ruta de acceso a la ubicación del campo JSON y seleccione el tipo de datos para él. -
Crear Índice como Sentencia DDL (para la entrada DDL avanzada): introduzca una sentencia DDL válida para crear un índice. También puede incluir un tipo de dato complejo, es decir, matriz, asignación y registro.
-
-
Haga clic en Agregar índice.
DROP INDEX
-
Localice el Explorador de esquemas y haga clic en el icono Refresh para volver a cargar el esquema.
-
Haga clic en la tabla de destino para ver las columnas mostradas, claves primarias, índices y claves de partición horizontal.
-
Busque el índice de destino que se debe borrar y haga clic con el botón derecho en él. Haga clic en Borrar índice.
-
Aparece una ventana de confirmación, haga clic en Aceptar para confirmar la acción de borrado.
AGREGAR COLUMNA
-
Localice el Explorador de esquemas y haga clic en el icono Refresh para volver a cargar el esquema.
-
Haga clic con el botón derecho en la tabla en la que se debe agregar la columna. Seleccione Agregar columna.
-
Puede agregar nuevas COLUMNAS en dos modos:
-
Entrada DDL simple: puede utilizar este modo para agregar nuevas columnas sin escribir una sentencia DDL. En caso de binario o binario fijo, seleccione el tipo de dato como
Binary. Para el binario fijo, introduzca el tamaño del archivo en el campoSizey mantenga el campo nulo en caso de que se trate de un tipo de dato binario. -
Entrada DDL avanzada: puede utilizar este modo para agregar nuevas columnas a la tabla proporcionando una sentencia DDL válida. Este modo también puede crear columnas de tipo de dato complejo. Por ejemplo, matriz, asignación o registro y también en formato anidado.
-
-
En ambos modos, especifique el nombre de la columna y defina la columna con sus propiedades: tipo de dato, valor por defecto y si es nulo.
-
Haga clic en Agregar columna.
BORRAR COLUMNA
-
Localice el Explorador de esquemas y haga clic en el icono Refresh para volver a cargar el esquema.
-
Haga clic en la tabla de destino para ver las columnas mostradas, claves primarias, índices y claves de partición horizontal.
-
Busque la columna de destino que se debe borrar y haga clic con el botón derecho en ella. Haga clic en Borrar columna.
-
Aparece una ventana de confirmación, haga clic en Aceptar para confirmar la acción de borrado.
Congelar/Descongelar Esquema
Debe congelar el esquema de una tabla singleton antes de convertirla en una tabla activa global. Una vez congelado el esquema de la tabla, no puede realizar ningún cambio en el esquema. Para congelar el esquema de una tabla singleton, debe tener al menos una columna JSON. Haga clic con el botón derecho en la tabla y seleccione Congelar/Descongelar. Una vez que confirme, el esquema de la tabla se congelará. Del mismo modo, para descongelar el esquema de la tabla, haga clic con el botón derecho en la tabla y seleccione Congelar/Descongelar. Una vez que confirme, el esquema de la tabla se vuelve a cambiar a mutable, lo que significa que el esquema se puede modificar.
Nota: Las réplicas regionales de la tabla se deben borrar (la tabla debe ser una tabla única) antes de que se pueda realizar la operación de descongelación.
Gestionar réplicas
Consulte Réplicas de Tabla Regional para comprender qué son las réplicas y cómo convertir una tabla singleton en una tabla activa global agregando réplicas regionales.
Agregar réplica
Puede agregar una réplica regional a una tabla única para convertirla en una tabla activa global o agregar una réplica a una tabla activa global existente. La tabla se debe congelar antes de agregarle una réplica. Haga clic con el botón derecho en la tabla y seleccione Agregar réplica en Réplicas regionales. Puede seleccionar una réplica de la lista desplegable de la región de replicación. Puede decidir las unidades de lectura y las unidades de escritura de la tabla en esa región de replicación. El valor de almacenamiento en disco de la tabla no se puede cambiar/editar en la réplica. Haga clic en Agregar réplica. La tabla se replica en la región.
Ver réplica
Haga clic con el botón derecho en la tabla y seleccione Ver réplicas en Réplicas regionales. Puede ver la lista de réplicas de la tabla.
Borrar réplicas
Haga clic con el botón derecho en la tabla y seleccione Borrar réplicas en Réplicas regionales. Haga clic en Agregar y seleccione la réplica que desea eliminar. Puede elegir más de una réplica para borrarla a la vez. Haga clic en Eliminar si desea eliminar la réplica de la lista de réplicas que se deben borrar. Haga clic en Borrar réplicas. Una vez que confirme, la tabla se borrará de todas las réplicas seleccionadas.
Editar capacidad reservada
Puede editar la capacidad reservada y el modelo de uso de una tabla. Haga clic con el botón derecho en la tabla y seleccione Editar Capacidad Reservada. Puede elegir uno de los dos modos de capacidad: capacidad aprovisionada o capacidad bajo demanda. Edite los valores y haga clic en Aplicar cambios.
Si la tabla que se edita es una tabla activa global:
-
El cambio en la capacidad de almacenamiento tiene un ámbito global (el cambio en una réplica de tabla regional se propaga automáticamente a todas las réplicas de tabla regional).
-
El cambio en las unidades de lectura, las unidades de escritura o el cambio en el modo de capacidad de On-Demand a provisionado o viceversa tiene un ámbito local (cambie solo en la réplica de la tabla regional en la que se inicia).
Realizar operaciones DML mediante IntelliJ
Puede agregar datos, modificar datos existentes y consultar datos de tablas mediante el plugin IntelliJ.
Insertar datos
-
Localice el Explorador de esquemas y haga clic en el icono Refrescar para volver a cargar el esquema.
-
Haga clic con el botón derecho en la tabla en la que se debe insertar una fila. Seleccione Insertar fila.
-
En el panel Insertar fila, introduzca los detalles para insertar una nueva fila. Puede insertar una nueva fila en dos modos:
-
Entrada simple: puede utilizar este modo para insertar la nueva fila sin escribir una sentencia DML. Aquí se carga una entrada de campos de fila basada en formularios, en la que puede introducir el valor de cada campo de la fila.
-
Para el tipo de dato binario, la cadena introducida debe ser una codificación Base64 válida de un valor binario o seleccione el archivo que desea cargar en la columna deseada.
-
Para el tipo de dato binario fijo, la cadena introducida debe ser una codificación Base64 válida de un valor binario o cargar el archivo de tamaño definido durante la creación de la columna concreta.
Nota: El formato de archivo que cargue para el tipo de dato binario solo debe tener la extensión
.bin. -
-
Entrada JSON avanzada: puede utilizar este modo para insertar una nueva fila en la tabla proporcionando un objeto JSON que contenga el nombre de columna y su valor correspondiente como pares clave-valor. La entrada también puede ser de tipo de dato complejo, es decir, matriz, asignación, registro.
-
-
Haga clic en Insertar fila.
Modificar datos - UPDATE ROW/DELETE ROW
-
Localice el Explorador de esquemas y haga clic en el icono Refrescar para volver a cargar el esquema.
-
Haga clic con el botón derecho en la tabla en la que se debe insertar una fila. Seleccione Examinar tabla.
-
En el cuadro de texto de la izquierda, introduzca la sentencia SQL para recuperar los datos de la tabla. Haga clic en Ejecutar para ejecutar la sentencia.
-
Para ver los datos de celdas individuales por separado, haga clic en la celda de la tabla.
-
Para realizar operaciones DML como Actualizar y Suprimir Fila, haga clic con el botón derecho en la fila concreta. Seleccione la opción en el menú contextual que aparece.
-
Suprimir fila: aparece una ventana de confirmación, haga clic en Aceptar para suprimir la fila.
-
Actualizar fila: se abre una ventana HTML independiente que muestra los nombres de columna y sus valores correspondientes. Puede introducir nuevos valores para los datos de fila en dos modos: entrada de campos de fila basada en formulario (entrada DDL simple) y Contenido de fila de suministro como objeto JSON (entrada DDL avanzada). En el modo de entrada DDL avanzada, los datos JSON se presentan como una estructura de árbol para simplificar la visualización y la actualización.
Seleccione Ejecutar para refrescar y ver los datos actualizados.
Nota: En cualquier fila, las columnas PRIMARY KEY y GENERATED ALWAYS AS IDENTITY no se pueden actualizar.
-
Tablas de consultas
-
Localice el Explorador de esquemas y haga clic en el icono Refrescar para volver a cargar el esquema.
-
Haga clic con el botón derecho en la tabla y seleccione Examinar Tabla.
-
En el cuadro de texto de la izquierda, introduzca la sentencia SELECT para recuperar datos de la tabla. Cuando empiece a escribir la consulta, se le mostrará la lista de posibles palabras para completar automáticamente la sentencia SQL. Todas las palabras clave SQL y los nombres de columna de la tabla proporcionada se proporcionan en la petición de datos para completar automáticamente la sentencia SQL.
-
La sintaxis SQL se resalta en cada consulta, lo que proporciona una mejor experiencia de escritura SQL.
-
Puede formatear la consulta para mejorar su legibilidad. Seleccione la consulta, haga clic con el botón derecho y seleccione Prettify. La consulta tiene formato y las líneas se ajustan para mejorar la legibilidad.
-
Haga clic en Ejecutar, para ejecutar la consulta. Los datos correspondientes se recuperan de la tabla. Al hacer doble clic en los datos recuperados, los datos de columna se abren en una nueva ventana. Cualquier dato JSON se muestra en una estructura de árbol en la nueva ventana. Haga clic en '+' para expandir o en '-' para contraer la estructura de árbol. Haga clic en Ctrl ^F en la nueva ventana para activar la opción de búsqueda, que permite buscar cualquier valor en el árbol de JSON. Haga clic en la flecha arriba o abajo para desplazarse a la ocurrencia de búsqueda anterior o siguiente, respectivamente.
-
Haga clic con el botón derecho en cualquier fila y haga clic en Descargar JSON. En el cuadro de diálogo, navegue hasta la ubicación en la que desea guardar el archivo y haga clic en Guardar. Una vez descargado el archivo, aparece una notificación en la parte inferior derecha de la pantalla. Haga clic en el enlace para abrir el archivo descargado. El archivo se abre en el explorador.
Nota: en el caso del tipo de dato Binario, simplemente haga clic en Descargar objeto binario en la salida.
-
Haga clic en Descargar resultado de consulta para descargar todos los datos del resultado de la consulta. En el cuadro de diálogo, navegue hasta la ubicación en la que desea guardar el archivo y haga clic en Guardar. En el caso de varias filas, aparece una barra de progreso en la parte inferior derecha de la pantalla para mostrar el número de filas descargadas en tiempo real. Una vez descargado el archivo, aparece una notificación en la parte inferior derecha de la pantalla. Haga clic en el enlace para abrir el archivo descargado. El archivo se abre en el explorador.
-
Haga clic en Mostrar plan de consulta para ver el plan de ejecución de la consulta.
-
Haga clic en la lista desplegable Comandos anteriores para ver las 20 sentencias SQL ejecutadas recientemente que han proporcionado una salida.
Nota: La lista desplegable solo mostrará las sentencias SQL relacionadas con la tabla en la que está trabajando.
Explorador de esquema
En la ventana Explorador de Esquemas, puede verificar el tipo de dato completo de una columna concreta. Busque la columna concreta y el tipo de dato va seguido del nombre de la columna.
Requisitos de autorización para el plugin IntelliJ
Obtenga información sobre los requisitos de autorización necesarios en Oracle NoSQL Database Cloud Service para utilizar el plugin de IntelliJ.
El plugin de IntelliJ permite acceder a Oracle NoSQL Database Cloud Service mediante métodos de autenticación de clave de API o de token de sesión. El acceso a los recursos de Oracle NoSQL Database Cloud Service, como tablas, tablespaces y API, se gestiona mediante políticas de gestión de identidad y acceso (IAM). Esto garantiza que solo los usuarios autenticados, que son miembros de grupos con los permisos de inspección, lectura, uso o gestión adecuados de la tabla en un compartimento determinado, puedan interactuar con estos recursos. Para obtener más información, consulte Gestión de acceso a tablas de NDCS.
Al utilizar el plugin de IntelliJ para gestionar tablas en tablas de Oracle NoSQL Database Cloud Service, los permisos de IAM efectivos determinan los recursos desde los que puede leer o escribir. Si un usuario intenta una acción para la que carece de autorización, el plugin de IntelliJ devolverá el error de autorización correspondiente proporcionado por OCI IAM.
Por ejemplo, OCI IAM deniega cualquier operación de inserción en una tabla de Oracle NoSQL Database Cloud Service si su grupo de usuarios solo tiene el permiso de "lectura" para las tablas NoSQL. Aparecerá el siguiente mensaje de error en el plugin IntelliJ:
Error executing Insert Row : Authorization failed or requested resource not found (5.4.18)