发布于: 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 包含三种类型的文件：
- 扩展名为 .env 的数据文件。这些文件包含可供我们查询的 PartiQL 数据。
- 扩展名为 .sql 的 PartiQL 查询文件。这些文件包含教程中使用的 PartiQL 查询。
- 扩展名为 .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)
PartiQL 是在 Apache2.0 许可下完全开源的语言。我们欢迎您在进一步扩展规范、构建技术以及提高其在用户社区中的应用和认知度方面做出的贡献。了解关于 PartiQL 的更多信息。
您可以通过为 good first issue 发送 Pull 请求来对项目作出贡献。在存在漏洞或缺少功能时提出问题。通读教程以了解 PartiQL 语法、它扩展 SQL 的方法，并逐步进行演练。想要了解 PartiQL 的每个细节？ 请通读规范。