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から依存してください。
クレートを追加
# 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?;
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 | 何ができるか |
|---|---|
encryption | disable (デフォルト)または require. |
ca_certificate | TLS 用の追加の PEM CA ファイルへのパス。 |
connect_timeout | TCP 接続、TLS、ログインを合わせて許容される秒数。 |
query_timeout | サーバー側のクエリタイムアウト(秒単位)。 |
max_rows | IRIS がクエリごとに返す総行数の上限です。フェッチサイズではありません。 |
fast_insert | 1 または 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、ベクトル | 予定 | まだ調査していません。 |