手把手教你如何使用 PartiQL 语言查询数据

发布于: Nov 30, 2022

【概要】PartiQL 开源实现提供交互式 shell（或 Read Evaluate Print Loop (REPL)），可使用户写入和评估 PartiQL 查询

入门

PartiQL 开源实现提供交互式 shell（或 Read Evaluate Print Loop (REPL)），可使用户写入和评估 PartiQL 查询。

先决条件

PartiQL 需要在您的机器上安装 Java Runtime (JVM)。您可以从 OpenJDK、OpenJDK for Windows 或 Oracle 中获取最新版本的 Java Runtime。

遵照安装 JDK 软件并将 JAVA_HOME 设置到您的 Java Runtime 安装所在路径的说明。

下载 PartiQL REPL

每个 PartiQL 版本都随附一个存档，其中包含压缩文件格式的 PartiQL REPL。

您可能必须要点击资产才能查看 zip 和 tgz 存档。下载最新的 partiql-cli zip 存档到您的机器中。该文件会将 PartiQL 的发行版本附加到存档中，即 partiql-cli-0.1.0.zip。

在您的机器上扩展（解压缩）存档，以生成以下文件夹结构（其中 ... 代表省略的文件/目录）：

├── partiql-cli
    ├── bin
    │   ├── partiql
    │   └── partiql.bat
    ├── lib
    │   └── ...
    ├── README.md
    └── Tutorial
        ├── code
        │   └── ...
        ├── tutorial.html
        └── tutorial.pdf

根文件夹 partiql-cli 包含 README.md 文件和三个子文件夹：

bin 包含启动脚本：partiql 适用于 macOS 和 Unix 系统，partiql.bat 适用于 Windows 系统。执行这些文件以启动 REPL。
lib 包含运行 PartiQL 所需的所有必要的 Java 库。
Tutorial 包含 pdf 和 html形式的教程。子文件夹 code 包含三种类型的文件：
1. 扩展名为 .env 的数据文件。这些文件包含可供我们查询的 PartiQL 数据。
2. 扩展名为 .sql 的 PartiQL 查询文件。这些文件包含教程中使用的 PartiQL 查询。
3. 扩展名为 .output 的示例查询输出文件。这些文件包含在适当数据上运行教程查询所生成的示例输出。

运行 PartiQL REPL

Windows

运行（双击）particl.bat。此操作应该会打开命令行提示符并且会启动 PartiQL REPL，屏幕将显示：

欢迎使用 PartiQL REPL！
PartiQL>

macOS (Mac) 和 Unix

打开终端并导航至 partiql-cli 文件夹。文件夹名称将以 PartiQL 版本作为后缀，即 partiql-cli-0.1.0。
键入 ./bin/partiql 并按下 ENTER 以启动 REPL，屏幕将显示：

欢迎使用 PartiQL REPL！
PartiQL>

测试 PartiQL REPL

写入简单的查询以验证您的 PartiQL REPL 是否在运行。在 PartiQL> 提示符类型：

PartiQL> SELECT * FROM [1,2,3]
 中

将 ENTER 按两次。输出应与以下内容类似：

PartiQL> SELECT * FROM [1,2,3]
   | 
===' 
<<
  {
    '_1': 1
  },
  {
    '_1': 2
  },
  {
    '_1': 3
  }
>>
--- 
OK! (86 ms)
PartiQL>?

祝贺您！您已成功安装并运行 PartiQL REPL。PartiQLREPL 正在等待更多的输入。

要退出 PartiQL REPL，请按：

macOS 或 Unix 中的 Control+D
Windows 中的 Control+C

或关闭终端/命令提示符窗口。

从文件中加载数据

将所需的数据加载到 REPL 中的一个简单方法是在启动 REPL 时使用 -e 开关及提供包含您数据的文件的名称：

./bin/partiql  -e Tutorial/code/q1.env

然后，您可以使用特殊的 REPL 命令 !global_env 查看加载到 REPL 全球环境中的内容，即，

欢迎使用 PartiQL REPL！
PartiQL> !global_env
   | 
===' 
{
  'hr': {
    'employees': <<
      {
        'id': 3,
        'name': 'Bob Smith',
        'title': NULL
      },
      {
        'id': 4,
        'name': 'Susan Smith',
        'title': 'Dev Mgr'
      },
      {
        'id': 6,
        'name': 'Jane Smith',
        'title': 'Software Eng 2'
      }
    >>
  }
}
--- 
OK! (6 ms)