Package dev.vortex.jni

Class NativeFiles

java.lang.Object

dev.vortex.jni.NativeFiles

public final class NativeFiles
extends Object

Static utilities for discovering, deleting, and inspecting the metadata and statistics of Vortex files on an object store. The caller supplies a Session; its runtime handle is forwarded to the underlying object store.

Method Summary

Modifier and Type	Method	Description
static void	delete(Session session, String[] uris, Map<String,String> options)	Delete files at the given URIs.
static List<String>	listFiles(Session session, String uri, Map<String,String> options)	List all Vortex files reachable under uri.
static Map<String,byte[]>	readMetadata(Session session, NativeReadable readable)	Read the user-defined metadata segments of a Vortex file through a caller-provided NativeReadable, instead of a native storage client.
static Map<String,byte[]>	readMetadata(Session session, String uri, Map<String,String> options)	Read the user-defined metadata segments written into the Vortex file at uri, as opaque bytes keyed by the names the VortexWriter builder was given.
static List<VortexColumnStatistics>	readStatistics(Session session, NativeReadable readable)	Read the per-column statistics of a Vortex file through a caller-provided NativeReadable, instead of a native storage client.
static List<VortexColumnStatistics>	readStatistics(Session session, String uri, Map<String,String> options)	Read the per-column statistics stored in the footer of the Vortex file at uri, in Arrow schema order.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

listFiles

public static List<String> listFiles(Session session,
 String uri,
 Map<String,String> options)

List all Vortex files reachable under uri.

delete

public static void delete(Session session,
 String[] uris,
 Map<String,String> options)

Delete files at the given URIs. Silently tolerates an empty list.

readMetadata

public static Map<String,byte[]> readMetadata(Session session,
 String uri,
 Map<String,String> options)

Read the user-defined metadata segments written into the Vortex file at uri, as opaque bytes keyed by the names the VortexWriter builder was given. Returns an empty map for a file that carries no metadata.

This opens the file on its own. Metadata lives in dedicated segments that opening a file does not read by default, so a segment that falls outside the file-tail read costs an extra round trip.

readMetadata

public static Map<String,byte[]> readMetadata(Session session,
 NativeReadable readable)

Read the user-defined metadata segments of a Vortex file through a caller-provided NativeReadable, instead of a native storage client. See readMetadata(Session, String, Map).

The readable must stay open for the duration of the call; native code never closes it.

NativeReadable.name() keys the file in the session's footer cache, exactly as it does when the readable is scanned, so reading metadata and then scanning the same file share one footer read.

readStatistics

public static List<VortexColumnStatistics> readStatistics(Session session,
 String uri,
 Map<String,String> options)

Read the per-column statistics stored in the footer of the Vortex file at uri, in Arrow schema order. Statistics the file does not store are empty in the returned values.

This opens the file on its own, but reads only the footer and no column data.

readStatistics

public static List<VortexColumnStatistics> readStatistics(Session session,
 NativeReadable readable)

Read the per-column statistics of a Vortex file through a caller-provided NativeReadable, instead of a native storage client. See readStatistics(Session, String, Map).

The readable must stay open for the duration of the call; native code never closes it.

NativeReadable.name() keys the file in the session's footer cache, exactly as it does when the readable is scanned, so reading statistics and then scanning the same file share one footer read.