InterSystems IRIS ドライバー

sqlly-iris、ネイティブ IRIS プロトコル用のオープンソースの非同期 Rust ドライバー: SQL、バルクインサート、プロシージャ、グローバル、サンプル、サポートマトリクス。

sqlly-iris は、InterSystems IRIS 用のオープンソースの非同期 Rust ドライバーです。ネイティブの xDBC プロトコルで IRIS スーパーサーバーポートと直接通信するため、ODBC ドライバーマネージャーもベンダーのクライアントライブラリも不要で、この crate には次のものは含まれません unsafe コード。Apache-2.0でバージョン0.1です。まだcrates.ioには公開されていないので、GitHubから依存してください。

ここでいう「サポート」の意味。 末尾の表の各行に、どうやってわかったのかが書かれています: テスト済み は、実環境での統合テストが IRIS 2026.1(プロトコル 69)に対して実行されることを意味します。 観測済み サーバーがそれを行うのを確認したが保証はしない、という意味で、 予定 「まだ未対応」を意味します。プロトコルにオペコードが存在していても、サポートとは見なされません。

クレートを追加

# Cargo.toml
[dependencies]
sqlly-iris = { git = "https://github.com/sql-ly/sqlly-iris" }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

接続、挿入、クエリ

? プレースホルダーは位置でバインドされ、文字列リテラル、引用符付き識別子、コメントの内部はそのまま残されます。日付と時刻は次のような ISO 形式のテキストとして渡されます 1815-12-10、ではない $HOROLOG 日数のカウントも扱い、テキストは Latin-1 と Unicode のどちらでもコードポイントごとに 1 文字を保持します。

use sqlly_iris::{Client, Config, Result, Value};

#[tokio::main]
async fn main() -> Result<()> {
    let config = Config::from_url("iris://_SYSTEM:[email protected]:1972/USER")?;
    let mut client = Client::connect(config).await?;
    println!("{}", client.server_info().product_info);

    client
        .execute(
            "INSERT INTO Sample.Person (Name, Born) VALUES (?, ?)",
            &[Value::from("Ada Lovelace"), Value::Date("1815-12-10".into())],
        )
        .await?;

    let rows = client
        .query("SELECT ID, Name, Born FROM Sample.Person WHERE ID > ?", &[Value::I32(0)])
        .await?
        .collect()
        .await?;
    for row in &rows {
        let name = row.get_by_name("Name")?.as_str();
        let born = row.get(2)?.as_str(); // Some("1815-12-10")
        println!("{name:?} born {born:?}");
    }

    client.close().await
}

トランザクション

コミットまたはロールバックを明示的に行ってください。どちらも行わずにトランザクションを破棄すると、意図的に接続が破棄されるため、誰も追跡していないトランザクション内で後続の処理が実行されることはありません。

let mut tx = client.begin().await?;
tx.execute("UPDATE Bank.Account SET Balance = Balance - ? WHERE ID = ?", &[Value::Decimal("25.00".into()), Value::I32(1)]).await?;
tx.execute("UPDATE Bank.Account SET Balance = Balance + ? WHERE ID = ?", &[Value::Decimal("25.00".into()), Value::I32(2)]).await?;
tx.commit().await?;

プリペアドステートメントとバルクインサート

次を使う場合 fast_insert オンの場合、IRIS は対象となるものを INSERT バッチを1つにまとめたリクエストで送ります。サーバーが拒否した行は、インデックス、SQLCODE、メッセージとともに1件ずつ報告され、残りは書き込まれます。全件成功か全件失敗にする必要がある場合は、バッチをトランザクションで囲んでください。

use sqlly_iris::Error;

let mut config = Config::from_url(&dsn)?;
config.fast_insert(true); // or ?fast_insert=1 in the URL
let mut client = Client::connect(config).await?;

let mut insert = client
    .prepare("INSERT INTO Lab.Reading (Sensor, Reading) VALUES (?, ?)")
    .await?;
let batches: Vec<Vec<Value>> = (0..5_000)
    .map(|n| vec![Value::String(format!("probe-{}", n % 4)), Value::F64(f64::from(n))])
    .collect();

match insert.execute_many(&batches).await {
    Ok(done) => println!("{} rows", done.rows_affected),
    Err(Error::BatchFailed { rows_affected, failures }) => {
        for f in &failures {
            eprintln!("row {} refused, SQLCODE -{}: {}", f.row, f.code, f.message);
        }
        println!("{rows_affected} rows still written");
    }
    Err(other) => return Err(other),
}
insert.close().await?;
高速挿入に関して確認した癖が 1 つあります: IRIS はパックされた行では列の長さチェックを省略するため、12 文字の値が格納されていたのは VARCHAR(5) 列。 NOT NULL そして一意制約は引き続き適用されます。長さは自分で検証するか、そのテーブルでは高速挿入をオフのままにしてください。

大規模な結果のストリーミング

行は読み取った分だけ取得されます。いつでも停止できます。ストリームを破棄すると残りの行は捨てられ、次のリクエストまでにステートメントが閉じられます。接続は引き続き使用できます。

use futures_util::TryStreamExt;

let mut rows = client.query("SELECT ID, Name FROM Sample.Person ORDER BY ID", &[]).await?;
while let Some(row) = rows.next_row().await? {
    if row.get(0)?.as_i64() == Some(1_000) { break; }
}
drop(rows);

let total = client
    .query("SELECT Reading FROM Lab.Reading", &[])
    .await?
    .into_stream()
    .try_fold(0.0, |sum, row| async move { Ok(sum + row.get(0)?.as_f64().unwrap_or(0.0)) })
    .await?;

ストアドプロシージャ

let results = client
    .call_procedure("Sample.TopPeople", &[Value::I32(10)])
    .await?
    .collect()
    .await?;
for result in &results {
    println!("return {:?}, {} rows", result.return_value, result.rows.len());
}

グローバルとオブジェクト

IRIS の非 SQL 側。存在しないノードは次のように表示されます Value::Null、そして global_data ノードが値、子、またはその両方を持っているかどうかを示します。

use sqlly_iris::GlobalDirection;

client.global_set("^Population", &Value::I64(650_000), &["Boston".into()]).await?;
let boston = client.global_get("^Population", &["Boston".into()]).await?;

// walk the first-level subscripts in collation order
let mut city = String::new();
while let Some(next) = client.global_order("^Population", &city, &[], GlobalDirection::Next).await? {
    println!("{next}");
    city = next;
}

let version = client.class_method("%SYSTEM.Version", "GetVersion", &[]).await?;

TLS

ネイティブのトラストルートが既定で使用されます。追加の CA ファイルはそれらに追加されるもので、置き換えたり、ホスト名チェックを無効にしたりすることはありません。また Encryption::Required 平文にフォールバックすることはありません。

use sqlly_iris::Encryption;

let mut config = Config::from_url("iris://_SYSTEM:[email protected]:1972/USER")?;
config.encryption(Encryption::Required).ca_certificate("/path/to/private-ca.pem");
let client = Client::connect(config).await?;

接続URL

iris://user:password@host:port/NAMESPACE?option=value。ポートの既定値は 1972 で、IPv6 ホストは角括弧で囲み、ユーザー名やパスワードの特殊文字はパーセントエンコードが必要で、不明なオプションは黙って無視されるのではなく拒否されます。

Option何ができるか
encryptiondisable (デフォルト)または require.
ca_certificateTLS 用の追加の PEM CA ファイルへのパス。
connect_timeoutTCP 接続、TLS、ログインを合わせて許容される秒数。
query_timeoutサーバー側のクエリタイムアウト(秒単位)。
max_rowsIRIS がクエリごとに返す総行数の上限です。フェッチサイズではありません。
fast_insert1 または 0。パラメーター配列を 1 つのリクエストにまとめます。
application_nameサーバー側から見える、この接続の名前。

現在使える機能

プロトコル 69 の IRIS 2026.1 ビルド 234U に対して検証済みです。これまでにテストしたバージョンはこれだけです。証拠付きの完全なマトリクスは、リポジトリの docs/compatibility.md.

エリア状態メモ
パスワードログインテスト済みネットワーク上を流れるパスワードのエンコーディングは可逆的な難読化にすぎないため、自分で管理していないネットワークでは TLS を使用してください。
直接実行とプリペアド SQLテスト済み結果が完了または破棄されたときにステートメントはクローズされます。20,000件のクエリを実行しても、サーバーのメモリ使用量は横ばいでした。
トランザクションと分離テスト済みオートコミット、読み取りコミット済み、読み取り未コミット、コミット、ロールバック。
ストアドプロシージャテスト済み入力パラメーター、スカラーの戻り値、複数の結果セット。
パラメーター配列と高速挿入テスト済みID 列、主キー、複合キーのテーブル、既定値、列の並べ替え、行単位の失敗。
データ型テスト済み整数、10 進数、倍精度浮動小数点数、ビット、Latin-1 と Unicode のテキスト、バイナリ、DATE、TIME、TIMESTAMP、長文テキストとバイナリ。
グローバル、メソッド、プロパティテスト済みネイティブエラーは IRIS のメッセージとともに返されます。例えば <METHOD DOES NOT EXIST>.
カタログテスト済みスキーマ、テーブル、列、プロシージャ。
TLS実装済み平文での接続が拒否されることはテスト済みですが、TLS 構成された IRIS サーバーに対するハンドシェイクの成功はまだテストされていません。
高速挿入時の長さチェック観測済みサーバーは、それらをパック済みの行には適用しません。
65,534 バイトを超える値予定現在は明確なエラーを返します。ストリームパラメーターで上限が解除される予定です。
出力パラメーター、プリペアドプロシージャ予定
生成されたキー予定まだ安定していないため、機能としては謳っていません。
Kerberos と OAuth予定
クライアント側キャンセル予定実行中のリクエストを破棄すると、サーバー側の処理をキャンセルする代わりに接続が使用停止になります。
古い IRIS リリース、XEP、ベクトル予定まだ調査していません。
独立した実装です。そして、そのことは礼儀正しく伝えています。 プロトコルは Apache-2.0 で通知されました。 go-irisnative プロジェクトで作成し、ベンダーの ODBC および JDBC ドライバーに対して確認しています。InterSystems と InterSystems IRIS は InterSystems Corporation の商標であり、このプロジェクトは同社と提携していません。見逃した IRIS の細かな挙動を見つけましたか? Issue を作成 実行した内容と IRIS が返した内容を添えて。