使用 IntelliJ 插件进行开发
从 IntelliJ 浏览表并对 Oracle NoSQL Database Cloud Service 实例或模拟器执行查询。
- 使用表浏览器查看定义良好的树结构中的表。
- 查看有关列、索引、主键和分片键的信息。
- 在格式正确的 JSON 结构中查看列数据。
- 使用基于表单的方案条目创建表，或者提供 DDL 语句。
- 删除表。
- 使用基于表单的条目添加新列，或者提供 DDL 语句。
- 删除列。
- 创建索引。
- 删除索引。
- 对表执行 SELECT SQL 查询并以表格格式查看查询结果。
- 执行 DML 语句在表中更新、插入和删除数据。
本文章包含以下主题：
设置 IntelliJ 插件
了解如何为 Oracle NoSQL Database Cloud Service 实例或模拟器设置 IntelliJ 插件。
作为先决条件，必须先安装 IntelliJ IDEA。可以从 JetBrains 下载 IntelliJ IDEA。
- 选项 2：从 Oracle Technology Network 安装。
注意：
可从 Oracle Technology Network 下载最新版本。- 从 Oracle Technology Network 下载 IntelliJ 插件。请勿提取文件。
- 启动 IntelliJ IDEA，导航到文件 > 设置 > 插件。您还可以通过选择位于主菜单栏右上角的 IDE and Project Settings 图标
来访问设置。
- 选择右上角的 Manage Repositories，Configure Proxy or Install Plugin from Disk 图标，然后选择 Install Plugin from disk （从磁盘安装插件）。
- 选择下载的插件 zip 文件。
重新启动 IDE。您将在右侧面板上看到 Schema Explorer（方案浏览器）图标。
成功设置 IntelliJ 插件后，创建一个 NoSQL 项目，并将其连接到 Oracle NoSQL Database Cloud Service 实例或模拟器。
在 IntelliJ 中创建 NoSQL 项目
了解如何在 IntelliJ 中创建 NoSQL 项目。
- 打开 IntelliJ IDEA。单击文件 > 新建 > 项目。
- 为项目名称和项目地点输入值。选择创建。
- 选择构建系统和 JDK 路径。
- IntelliJ 将创建 NoSQL 项目目录，其中包括示例 Java 文件。如果已选择 Maven 作为构建系统，则项目目录还包括一个 pom.xml 文件。
- 确保为 Oracle NoSQL 项目启用了通知。要启用通知，请按
Alt+\打开主菜单。单击查看，展开工具窗口 > 通知。通知图标
出现在右侧工具窗口栏中。
从 IntelliJ 连接到 Oracle NoSQL Database Cloud Service
了解如何使用 IntelliJ 插件将 NoSQL 项目连接到 Oracle NoSQL Database Cloud Service
- 单击模式浏览器窗口中的任务图标 以打开插件的设置对话框。
从 IntelliJ 连接到 Oracle NoSQL Database Cloud Simulator
了解如何使用 IntelliJ 插件将 NoSQL 项目连接到 Oracle NoSQL Database Cloud Simulator 。
- 单击模式浏览器窗口中的任务图标 以打开插件的设置对话框。
使用 IntelliJ 插件管理表
了解如何在 Oracle NoSQL Database Cloud Service 或 Oracle NoSQL Database Cloud Simulator 中从 IntelliJ 创建表和查看表数据。
- 查看表及其数据：
- 找到方案浏览器，然后单击
图标以重新加载方案。 - 在租户标识符下找到
audienceData表，然后展开该表以查看其列、主键和分片键详细信息。 - 双击表名以查看其数据。或者，可以右键单击该表，然后选择浏览表。
- 记录查看器窗口将显示在主编辑器中。单击执行以运行查询并显示表数据。
- 要单独查看单个单元格数据，请双击该单元格。
- 找到方案浏览器，然后单击
使用 IntelliJ 执行 DDL 操作
可以使用 IntelliJ 执行 DDL 操作。
CREATE TABLE
- 找到方案浏览器，然后单击刷新图标以重新加载方案。
- 右键单击连接名称，然后选择创建表。
- 在提示中，输入新表的详细信息。可以采用两种模式创建 Oracle NoSQL Database 表：
- ** 简单 DDL 输入 **：可以使用此模式以声明方式创建表，即不编写 DDL 语句。
- ** 高级 DDL 输入 **：可以使用此模式通过 DDL 语句创建表。
- 您可以选择在创建 DDL 语句之前查看该语句。单击显示 DDL 可查看基于在简单 DDL 输入模式下字段中输入的值形成的 DDL 语句。单击“Create（创建）”时将执行此 DDL 语句。
- 单击创建创建表。
- 要创建子表，请右键单击所需的表，然后选择创建子表。可以采用两种模式创建子表：
- ** 简单 DDL 输入 **：只需输入表名以及其他必需的详细信息，即可使用此模式创建子表。
- ** 高级 DDL 输入 **：可以使用此模式通过 DDL 语句创建子表。
有关子表的更多详细信息，请参阅 Oracle NoSQL Database Cloud Service Guide 中的 Table Hierarchies 。
- 单击创建可创建子表。
- 您可以选择在创建表后查看 DDL 语句。右键单击现有表。选择查看表 DDL 。要复制 DDL 语句，请单击 Copy to Clipboard 。单击确定可关闭对话框。
删除表
- 找到方案浏览器，然后单击“Refresh（刷新）”图标以重新加载方案。
- 右键单击要删除的表。选择删除表。
- 此时将显示一个确认窗口，单击确定以确认放置操作。
创建索引
- 找到方案浏览器，然后单击“Refresh（刷新）”图标以重新加载方案。
- 右键单击需要创建索引的表。选择创建索引。
- 在“创建索引”面板中，可以选择在两种模式下创建索引：
- ** 基于表单的索引创建（简单 DDL 输入）**：输入用于创建索引而不写入任何 DDL 语句的详细信息。指定索引的名称以及要包含在索引中的列。如果列的数据类型为 JSON，则会显示一个名为 "
JSON Path to Index Field" 的附加字段。输入 JSON 字段位置的路径，然后选择其数据类型。 - ** 将索引创建为 DDL 语句（用于高级 DDL 输入）**：输入有效的 DDL 语句以创建索引。它还可以包括复杂数据类型，例如数组、映射和记录。
- ** 基于表单的索引创建（简单 DDL 输入）**：输入用于创建索引而不写入任何 DDL 语句的详细信息。指定索引的名称以及要包含在索引中的列。如果列的数据类型为 JSON，则会显示一个名为 "
- 单击添加索引。
删除索引
- 找到方案浏览器，然后单击“Refresh（刷新）”图标以重新加载方案。
- 单击目标表可查看列出的列、主键、索引和分片键。
- 找到必须删除的目标索引，然后右键单击它。单击删除索引。
- 此时将显示一个确认窗口，单击确定以确认放置操作。
添加列
- 找到方案浏览器，然后单击“Refresh（刷新）”图标以重新加载方案。
- 右键单击需要添加列的表。选择添加列。
- 可以采用两种模式添加新的列：
- 简单 DDL 输入：可以使用此模式添加新列，而无需编写 DDL 语句。如果是二进制或固定二进制文件，请选择数据类型
Binary。对于固定二进制文件，在Size字段中输入文件大小，如果是二进制数据类型，则将该字段保留为空值。 - 高级 DDL 输入：可以使用此模式通过提供有效的 DDL 语句向表中添加新列。此模式还可以创建复杂数据类型的列。例如，数组、映射或记录，以及嵌套格式。
- 简单 DDL 输入：可以使用此模式添加新列，而无需编写 DDL 语句。如果是二进制或固定二进制文件，请选择数据类型
- 在这两种模式下，请指定列的名称并使用列的属性（数据类型、默认值以及列是否可为空）来定义列。
- 单击添加列。
删除列
- 找到方案浏览器，然后单击“Refresh（刷新）”图标以重新加载方案。
- 单击目标表可查看列出的列、主键、索引和分片键。
- 找到必须删除的目标列，然后右键单击它。单击删除列。
- 此时将显示一个确认窗口，单击确定以确认放置操作。
冻结/UnFreeze 方案
注意：
需要先删除表区域副本（表必须是单例表），然后才能执行解冻操作。管理副本
要了解什么是副本以及如何通过添加区域副本将单例表转换为全局活动表，请参见 Regional Table Replicas 。
可以将区域副本添加到单例表，使其成为全局活动表或将副本添加到现有全局活动表。在向表添加副本之前，应先冻结该表。右键单击该表，然后从区域副本中选择添加副本。可以从复制区域的下拉列表中选择副本。可以决定该复制区域中表的读取单位数和写入单位数。无法在副本中更改/编辑表的磁盘存储值。单击 Add Replica 。将在该区域中复制表。
右键单击该表，然后从区域副本中选择查看副本。您可以查看表的副本列表。
右键单击该表，然后从区域副本中选择删除副本。单击添加，然后选择要删除的副本。您可以选择一次删除多个副本。如果要从需要删除的副本列表中删除副本，请单击删除。单击删除副本。确认后，将从所有选定副本中删除该表。
编辑预留容量
您可以编辑表的保留容量和使用模型。右键单击该表，然后选择编辑保留容量。您可以选择以下两种容量模式之一：预配容量或按需容量。编辑值并单击应用更改。
- 存储容量更改具有全局范围（一个区域表副本中的更改将自动传播到所有区域表副本）。
- 读取单位数、写入单位数或容量模式从“按需”更改为“已预配”，反之亦然，更改具有本地范围（仅在启动该更改的区域表副本中更改）。
使用 IntelliJ 执行 DML 操作
可以使用 IntelliJ 插件添加数据、修改现有数据以及从表中查询数据。
插入数据
- 找到 Schema Explorer ，然后单击 Refresh（刷新）图标以重新加载方案。
- 右键单击需要插入行的表。选择插入行。
- 在“插入行”面板中，输入插入新行的详细信息。可以采用两种模式插入新 ROW：
- 简单输入：可以使用此模式插入新行，而无需编写 DML 语句。在此加载基于表单的行字段条目，您可以在其中输入行中每个字段的值。
- 对于二进制数据类型，键入的字符串应为二进制值的有效 Base64 编码，或者选择要在所需列中上载的文件。
- 对于固定二进制数据类型，键入的字符串应为二进制值的有效 Base64 编码，或者上载在创建特定列期间定义的大小文件。
注意：
为二进制数据类型上载的文件格式应仅具有.bin扩展名。 - 高级 JSON 输入：您可以使用此模式通过提供包含列名及其对应值的 JSON 对象作为键 - 值对来向表中插入新行。输入也可以是复杂的数据类型，即数组、映射、记录。
- 简单输入：可以使用此模式插入新行，而无需编写 DML 语句。在此加载基于表单的行字段条目，您可以在其中输入行中每个字段的值。
- 单击插入行。
修改数据 - UPDATE ROW/DELETE ROW
- 找到 Schema Explorer ，然后单击 Refresh（刷新）图标以重新加载方案。
- 右键单击需要插入行的表。选择浏览表。
- 在左侧的文本框中，输入 SQL 语句以从表中提取数据。单击执行以运行该语句。
- 要单独查看单个单元格数据，请单击表单元格。
- 要执行“Update（更新）”和“Delete Row（删除行）”等 DML 操作，请右键单击特定行。从显示的上下文菜单中选择您的选项。
- 删除行：此时将显示一个确认窗口，单击确定删除该行。
-
更新行：将打开一个单独的 HTML 窗口，其中显示列名及其对应的值。可以采用两种模式为行数据输入新值：基于表单的行字段输入（简单 DDL 输入）和将行内容作为 JSON 对象（高级 DDL 输入）提供。在高级 DDL 输入模式下，JSON 数据以树结构形式显示，以简化查看和更新。
选择执行可刷新和查看更新的数据。
注意：
在任何行中，都不能更新 PRIMARY KEY 和 GENERATED ALWAYS AS IDENTITY 列。
表查询
- 找到 Schema Explorer ，然后单击 Refresh（刷新）图标以重新加载方案。
- 右键单击该表，然后选择浏览表。
- 在左侧的文本框中，输入 SELECT 语句以从表中提取数据。当您开始键入查询时，系统会提示您提供可自动完成 SQL 语句的单词列表。提示中提供了给定表的所有 SQL 关键字和列名，以自动完成 SQL 语句。
- SQL 语法在每个查询中都会突出显示，这样可以提供更好的 SQL 编写体验。
- 您可以设置查询的格式以提高其可读性。选择查询，右键单击并选择 Prettify 。查询已设置格式并换行以提高可读性。
- 单击执行以运行查询。将从表中检索相应的数据。双击检索到的数据后，列数据将在新窗口中打开。任何 JSON 数据都以树结构显示在新窗口中。单击 ' + ' 展开，或单击 ' - ' 折叠树结构。在新窗口中单击 Ctrl ^F 以启用搜索选项，通过该选项可以搜索 JSON 树中的任何值。单击向上或向下箭头可分别移动到上一个或下一个搜索匹配项。
- 右键单击任意行，然后单击下载 JSON 。在该对话框中，导航到要保存文件的位置，然后单击保存。下载文件后，屏幕右下方会显示一条通知。单击该链接以打开下载的文件。该文件将在浏览器中打开。
- 对于二进制数据类型，只需在输出中单击 Download Binary Object（下载二进制对象）。
- 单击下载查询结果可下载查询结果中的所有数据。在该对话框中，导航到要保存文件的位置，然后单击保存。对于多行，屏幕右下方会显示一个进度条，以显示实时下载的行数。下载文件后，屏幕右下方会显示一条通知。单击该链接以打开下载的文件。该文件将在浏览器中打开。
- 单击显示查询计划可查看查询的执行计划。
- 单击 Previous Commands（上一个命令）下拉列表，查看最近执行的已提供输出的前 20 个 SQL 语句。
注意：
下拉列表将仅显示与您正在处理的表相关的 SQL 语句。
模式浏览器
- 在 Schema Explorer（方案浏览器）窗口中，可以验证特定列的完整数据类型。找到特定列，数据类型后跟列名。