InterSystems IRIS 드라이버

sqlly-iris - 네이티브 IRIS 프로토콜용 오픈 소스 비동기 Rust 드라이버. SQL, 대량 삽입, 프로시저와 글로벌을 다루며 샘플과 지원 매트릭스가 있습니다.

sqlly-iris 은 InterSystems IRIS용 오픈 소스 비동기 Rust 드라이버입니다. IRIS 슈퍼서버 포트로 네이티브 xDBC 프로토콜을 바로 사용하므로 ODBC 드라이버 매니저도 벤더 클라이언트 라이브러리도 필요 없으며, 이 크레이트에는 다음이 없습니다 unsafe 코드입니다. Apache-2.0이고 버전은 0.1입니다. 아직 crates.io에는 없으니 GitHub 저장소에서 의존성을 가져오세요.

여기서 말하는 "지원"의 의미. 마지막 표의 각 행은 이를 어떻게 알았는지 보여 줍니다: tested 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 모두에서 코드 포인트당 한 글자를 유지합니다.

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?;

Prepared statements와 대량 삽입

와/과 fast_insert 가 켜져 있으면 IRIS는 적합한 INSERT 패킹된 요청 하나로 여러 배치를 보냅니다. 서버가 거부한 행은 인덱스와 SQLCODE, 메시지와 함께 하나씩 보고되고 나머지 행은 그대로 기록되므로, 전부 아니면 전무여야 한다면 배치를 트랜잭션으로 감으세요.

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?;
직접 관찰한 빠른 삽입의 특이한 동작 하나: 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 호스트는 괄호 안에 작성하고, 사용자 이름이나 비밀번호의 특수 문자는 퍼센트 인코딩해야 하며, 알 수 없는 옵션은 조용히 무시되지 않고 거부됩니다.

옵션기능
encryptiondisable (기본) 또는 require.
ca_certificateTLS용 추가 PEM CA 파일 경로.
connect_timeoutTCP 연결, TLS, 로그인에 허용되는 총 시간(초).
query_timeout서버 측 쿼리 타임아웃(초).
max_rowsIRIS가 쿼리당 반환하는 총 행 수입니다. 이는 가져오기 크기가 아니라 상한치입니다.
fast_insert1 또는 0. 매개변수 배열을 하나의 요청으로 묶어 보냅니다.
application_name서버가 이 연결에서 보는 이름입니다.

현재 지원되는 것

프로토콜 69 기준, 지금까지 테스트된 유일한 버전인 IRIS 2026.1 빌드 234U에서 검증했습니다. 증거가 담긴 전체 매트릭스는 저장소의 docs/compatibility.md.

영역상태메모
비밀번호 로그인tested전송 중 비밀번호 인코딩은 되돌릴 수 있는 난독화이므로, 직접 소유하지 않은 네트워크에서는 TLS를 사용하세요.
직접 SQL과 준비된 SQLtested결과가 끝나거나 버려지면 문장을 닫습니다. 20,000개 쿼리를 내는 동안 서버 메모리는 그대로였습니다.
트랜잭션과 격리tested자동 커밋, read committed, read uncommitted, 커밋, 롤백.
저장 프로시저tested입력 매개변수, 스칼라 반환, 다중 결과 집합.
매개변수 배열 및 빠른 삽입testedIDENTITY, 기본 키, 복합 키 테이블, 기본값, 열 재정렬, 행별 실패.
데이터 유형tested정수, 정확한 소수, 배정밀도 부동소수점, 비트, Latin-1 및 유니코드 텍스트, 바이너리, DATE, TIME, TIMESTAMP, 그리고 긴 텍스트와 바이너리.
글로벌, 메서드, 속성tested네이티브 오류는 IRIS 메시지와 함께 돌아옵니다. 예를 들어 <METHOD DOES NOT EXIST>.
카탈로그tested스키마, 테이블, 열, 프로시저.
TLS구현됨평문 접속 거부는 테스트되었습니다. TLS가 설정된 IRIS 서버와의 성공적인 핸드셰이크는 아직 테스트 전입니다.
빠른 삽입 길이 검사관측됨서버는 압축된 행에는 이를 적용하지 않습니다.
65,534 바이트를 초과하는 값예정됨현재는 명확한 오류를 반환함; 스트림 매개변수가 나오면 이 제한은 풀림.
출력 매개변수, 프리페어드 프로시저예정됨
생성된 키예정됨아직 신뢰할 만하지 않아 내세우지 않음.
Kerberos 및 OAuth예정됨
클라이언트 측 취소예정됨진행 중인 요청을 드롭하면 서버 작업을 취소하는 게 아니라 연결을 폐기합니다.
구형 IRIS 릴리스, XEP, 벡터예정됨아직 조사되지 않음.
독립적으로 만들었고, 그 점은 정중히 밝힙니다. 프로토콜 작업은 아래의 Apache-2.0 go-irisnative 프로젝트는 벤더 ODBC 및 JDBC 드라이버와 대조해 검증했습니다. InterSystems와 InterSystems IRIS는 InterSystems Corporation의 상표이며 이 프로젝트는 해당 회사와 무관합니다. 빠뜨린 IRIS 관련 내용을 찾으셨나요? 이슈 열기 실행한 것과 IRIS의 응답이 함께 담깁니다.