Xandra 开源项目教程

Xandra 开源项目教程

xandraFast, simple, and robust Cassandra/ScyllaDB driver for Elixir.项目地址:https://gitcode.com/gh_mirrors/xa/xandra

项目介绍

Xandra 是一个用 Elixir 编写的 Cassandra 驱动程序，它提供了一个简单且高效的接口来与 Cassandra 数据库进行交互。Xandra 的设计目标是提供一个稳定、高性能的 Cassandra 客户端库，支持 Cassandra 的所有主要功能，如批处理、事务、预编译语句等。

项目快速启动

安装

首先，确保你已经安装了 Elixir 和 Erlang。然后，在你的 mix.exs 文件中添加 Xandra 作为依赖：

defp deps do
  [
    {:xandra, "~> 0.15.0"}
  ]
end

运行 mix deps.get 来安装依赖。

连接到 Cassandra

以下是一个简单的示例，展示如何连接到 Cassandra 并执行一个查询：

defmodule MyApp.Xandra do
  use GenServer

  def start_link(_) do
    GenServer.start_link(__MODULE__, :ok, name: __MODULE__)
  end

  def init(:ok) do
    options = [
      nodes: ["127.0.0.1:9042"],
      pool: DBConnection.Poolboy
    ]

    {:ok, conn} = Xandra.start_link(options)
    {:ok, conn}
  end

  def execute(query) do
    GenServer.call(__MODULE__, {:execute, query})
  end

  def handle_call({:execute, query}, _from, conn) do
    {:ok, result} = Xandra.execute(conn, query, _params = [], _options = [])
    {:reply, result, conn}
  end
end

执行查询

你可以使用 MyApp.Xandra.execute/1 函数来执行 CQL 查询：

query = "SELECT * FROM my_keyspace.my_table"
result = MyApp.Xandra.execute(query)
IO.inspect(result)

应用案例和最佳实践

批处理

Xandra 支持批处理操作，可以一次性执行多个语句，提高性能：

batch =
  Xandra.Batch.new()
  |> Xandra.Batch.add("INSERT INTO users (id, name) VALUES (1, 'Alice')")
  |> Xandra.Batch.add("INSERT INTO users (id, name) VALUES (2, 'Bob')")

Xandra.execute(conn, batch)

预编译语句

使用预编译语句可以提高查询性能并防止 SQL 注入：

prepared = Xandra.prepare!(conn, "INSERT INTO users (id, name) VALUES (?, ?)")
Xandra.execute(conn, prepared, [3, "Charlie"])

典型生态项目

Xandra 可以与其他 Elixir 项目和库集成，例如：

• Phoenix Framework: 用于构建 Web 应用程序，可以与 Xandra 集成以处理数据库操作。
• Ecto: 一个 Elixir 的数据库库，可以与 Xandra 结合使用，提供更高级的数据库操作功能。

通过这些集成，你可以构建强大的 Elixir 应用程序，充分利用 Cassandra 数据库的强大功能。

xandraFast, simple, and robust Cassandra/ScyllaDB driver for Elixir.项目地址:https://gitcode.com/gh_mirrors/xa/xandra