如何下载和安装 Cassandra on Windows
大卫卡特
⚡ 智能摘要
下载并安装 Cassandra on Windows 由于旧版屏幕截图中显示的 DataStax Community Edition 安装程序已于 2017 年停用，因此需要解压官方的 Apache 二进制发行版。本页涵盖先决条件、两种安装途径和启动验证。
Apache (阿帕奇) Cassandra 小型组织使用 DataStax Enterprise，而大型组织则使用 DataStax Enterprise 来存储海量数据。
Apache Cassandra 由 Apache 软件管理 Foundation.
先决条件 Apache Cassandra 安装
三个条件必须具备 Cassandra 将开始 Windows.
- Apache Cassandra 二进制文件。 您还可以 download Cassandra 从 Apache 网站下载。下载当前稳定版本的二进制压缩包。
- 受支持的 JDK。 Java 必须安装 JDK，并且 JAVA_HOME 环境变量必须指向 JDK 文件夹。 Cassandra 4.x 运行于 Java 8年或11年； Cassandra 5.x 运行于 Java 11或17。
- Python. cqlsh 命令行客户端是一个 Python 程序，所以一个 Python 需要安装 3 才能打开 CQL shell。
64 位 Windows 本文所有操作均基于同一平台。请注意。 Windows 这是一个未经充分测试的平台。 Cassandra因此，后面描述的容器路线通常是更顺畅的选择。
如何下载和安装 Cassandra
有两种安装方法。本节中的屏幕截图来自 DataStax 社区版向导，这也是大多数现有教程所描述的方法。该安装程序已不再发布，因此首先介绍当前的二进制安装方法，之后再保留向导，供使用存档副本的读者参考。
方法一：从 Apache 二进制归档文件安装（当前方法）
步骤1） 从上面链接的 Apache 下载页面下载二进制压缩包，例如 apache-cassandra-xyz-bin.tar.gz。将该文件与同一页面上公布的校验和进行比对。
步骤2） Extrac将归档文件保存到不带空格的路径，例如 C:\cassandra。路径中的空格会导致启动脚本失败。
步骤3） 创建两个环境变量 Cassandra 如果预期结果为真，则将 bin 文件夹添加到 PATH。
setx CASSANDRA_HOME "C:\cassandra" setx JAVA_HOME "C:\Program Files\Java\jdk-17" setx PATH "%PATH%;C:\cassandra\bin"
步骤4） 打开一个新的命令提示符窗口，使变量生效，然后在前台启动节点。
cd C:\cassandra\bin cassandra -f
保持窗口打开。启动日志的最后一行显示，节点正在监听端口 9042 上的 CQL 客户端。
步骤5） 在第二个命令提示符窗口中，确认节点已启动，然后打开 shell。
nodetool status cqlsh 127.0.0.1 9042
以……开头的状态行 UN 表示节点已启动且运行正常。cqlsh 提示符确认安装已完成。
方法二：DataStax 社区版向导（旧版）
以下截图记录了已停用的 MSI 安装程序。对于已经拥有该安装程序的用户来说，这些截图仍然有用，并且生成的 shell 的行为完全相同。
步骤1） 运行 DataStax 社区版安装程序。安装程序运行后，将显示以下页面。截图中显示的是正在安装的 64 位版本。您也可以根据需要下载 32 位版本，但建议使用 64 位版本。
本页面为您提供有关 Cassandra 您要安装的版本。按“下一步”按钮。
步骤2） 按下“下一步”按钮。按下“下一步”按钮后，将显示下一页。
本页是关于许可协议的。勾选复选框并按下一步按钮。
步骤3） 点击“下一步”按钮。下一页将显示安装位置信息。
- 默认位置为 C:\Program Files。如果您想要更改安装位置，可以更改。建议不要更改安装位置。
- 设置安装位置后，按“下一步”按钮
步骤4） 开始 Cassandra 以及 OpsCenter。在上一步中按下“下一步”按钮后，将显示以下页面。此页面询问您是否要自动启动 Cassandra 和 OpsCenter。
- 如果要自动启动，请勾选复选框 Cassandra 和 OpsCenter。
- 提供此信息后，按“下一步”按钮。
步骤5） 点击安装按钮。安装程序已收集所有必要信息，现在可以开始安装。点击安装按钮。
步骤6） 点击“下一步”。按下“安装”按钮后，将显示以下页面。
DataStax社区版正在安装。安装完成后，点击“下一步”按钮。安装成功后，点击“完成”按钮。
转到 Windows 开始程序，搜索 Cassandra CQL Shell 并运行 Cassandra Shell。运行后 Cassandra shell 中，你会看到以下命令行
现在您可以创建键空间、表并编写查询。
运行 Cassandra 在 Docker 中 Windows
以上两种方法均运行 Cassandra 直接 Windows这是该项目测试最少的平台。容器避免了…… Java 路径、服务注册和文件权限问题会导致大多数问题。 Windows 安装失败后，它会干净利落地移除节点。
安装 Docker Desktop 后，只需一条命令即可启动一个可运行的单节点。
docker run --name cassandra-node -p 9042:9042 -d cassandra:latest
给节点大约一分钟时间进行引导，然后检查其状态并打开容器内的 shell。
docker exec -it cassandra-node nodetool status docker exec -it cassandra-node cqlsh
以这种方式写入的数据保存在容器内部，容器移除时数据也会消失。要保留这些数据，请将卷附加到数据目录：
docker run --name cassandra-node -p 9042:9042 \ -v cassandra-data:/var/lib/cassandra -d cassandra:latest
对于学习和本地开发而言，这条路线是切实可行的选择，因为损坏的节点会在几秒钟内被丢弃并重新创建。
故障排除 Cassandra 安装于 Windows
启动失败 Windows 这些故障可归结为少数几种常见原因。每种原因都会在控制台中产生不同的信息。
| 症状 | 原因及解决方法 |
|---|---|
| “JAVA_HOME 未设置” | 该变量缺失或指向的是 JRE 而不是 JDK。请将其设置为 JDK 文件夹，然后打开一个新的命令提示符窗口。 |
| 进程立即退出，不记录任何日志。 | 安装路径中包含空格。请将文件夹移动到类似 C:\cassandra 的路径。 |
| “无法与同龄人闲聊八卦” | 之前启动失败导致数据过时。请停止节点并清除安装目录下的 data 和 commitlog 文件夹。 |
| “地址已被使用” | 端口 9042 或 7000 被另一个进程占用，通常是先前的进程。 Cassandra 运行。关闭它或更改 cassandra.yaml 中的端口。 |
| cqlsh 报告“没有名为 cqlshlib 的模块” | Python 缺少或 PATH 环境变量中第一个路径的版本错误。请安装 Python 3 并使用 python --version 进行确认。 |
一旦节点报告了 UN 并且 cqlsh 连接成功，下一步就是创建存储结构，这部分内容将在下文中介绍。 Cassandra 键空间 教程，然后是 Cassandra 表 教程。
