읽기 작업

Key

모든 record는 (namespace, set, primary_key) key tuple로 식별합니다.

key = ("test", "demo", "user1")      # string PK
key = ("test", "demo", 12345)         # integer PK
key = ("test", "demo", b"\x01\x02")   # bytes PK

Read

Sync

from aerospike_py import Record

record: Record = client.get(key)
print(record.bins)       # {"name": "Alice", "age": 30}
print(record.meta.gen)   # 1
print(record.meta.ttl)   # 2591998

# Tuple unpacking (backward compat)
_, meta, bins = client.get(key)

# 특정 bin 만 읽기
record = client.select(key, ["name"])
# record.bins = {"name": "Alice"}

Async

record: Record = await client.get(key)
_, meta, bins = await client.get(key)
record = await client.select(key, ["name"])

Exists

from aerospike_py import ExistsResult

result: ExistsResult = client.exists(key)  # 또는: await client.exists(key)
if result.meta is not None:
    print(f"gen={result.meta.gen}")

Batch Read

여러 record를 하나의 batch API call로 읽습니다. Client는 각 key를 소유한 node로 요청을 보내므로 multi-node batch에서는 network request가 여러 번 발생할 수 있습니다.

Sync

keys: list[tuple] = [("test", "demo", f"user_{i}") for i in range(10)]

# 모든 bin — `LazyBatchRecords` 반환. dict-style Mapping
# protocol (`items`, `keys`, `values`, `get`, `__getitem__`, `__iter__`,
# `__contains__`, `__len__`) 이 단일 cached `to_dict()` materialisation 으로
# backed 되어 명시 변환 없이 iterate 가능. plain mutable dict 가 명시적으로
# 필요하면 `batch.to_dict()` 호출.
batch = client.batch_read(keys)
for user_key, bins in batch.items():
    print(user_key, bins)

# 특정 bin
batch = client.batch_read(keys, bins=["name", "age"])

# 존재만 확인
batch = client.batch_read(keys, bins=[])

Async

# sync path 와 동일한 `LazyBatchRecords`; dict-style iteration 은
# cached `to_dict()` materialisation 으로 backed.
batch = await client.batch_read(keys, bins=["name", "age"])
for user_key, bins in batch.items():
    print(user_key, bins)

팁

• Batch size: batch당 100–5,000개 key를 권장합니다. Batch가 너무 크면 timeout이 발생할 수 있습니다.
• Timeout: 큰 batch operation에는 더 긴 total_timeout을 사용하세요.
• Error handling: Mapping view에는 user key가 있는 성공한 record만 들어 있습니다. 요청한 user key와 batch.keys()를 비교하면 누락된 key를 찾을 수 있습니다. RecordNotFound와 다른 per-record error를 구분해야 한다면 batch.iter_records()를 순회하며 각 br.result를 확인하세요.