Storage provider that writes ntuple pages to into a DAOS container.
Currently, an object is allocated for ntuple metadata (anchor/header/footer). Objects can correspond to pages or clusters of pages depending on the RNTuple-DAOS mapping strategy.
Definition at line 101 of file RPageStorageDaos.hxx.
|
| RPageSinkDaos (std::string_view ntupleName, std::string_view uri, const RNTupleWriteOptions &options) |
|
| ~RPageSinkDaos () override |
|
| RPagePersistentSink (const RPagePersistentSink &)=delete |
|
| RPagePersistentSink (RPagePersistentSink &&)=default |
|
| RPagePersistentSink (std::string_view ntupleName, const RNTupleWriteOptions &options) |
|
| ~RPagePersistentSink () override |
|
ColumnHandle_t | AddColumn (DescriptorId_t fieldId, RColumn &column) final |
| Register a new column.
|
|
void | CommitClusterGroup () final |
| Write out the page locations (page list envelope) for all the committed clusters since the last call of CommitClusterGroup (or the beginning of writing).
|
|
void | CommitPage (ColumnHandle_t columnHandle, const RPage &page) final |
| Write a page to the storage. The column must have been added before.
|
|
void | CommitSealedPage (DescriptorId_t physicalColumnId, const RPageStorage::RSealedPage &sealedPage) final |
| Write a preprocessed page to storage. The column must have been added before.
|
|
void | CommitSealedPageV (std::span< RPageStorage::RSealedPageGroup > ranges) final |
| Write a vector of preprocessed pages to storage. The corresponding columns must have been added before.
|
|
void | CommitStagedClusters (std::span< RStagedCluster > clusters) final |
| Commit staged clusters, logically appending them to the ntuple descriptor.
|
|
void | CommitSuppressedColumn (ColumnHandle_t columnHandle) final |
| Commits a suppressed column for the current cluster.
|
|
const RNTupleDescriptor & | GetDescriptor () const final |
| Return the RNTupleDescriptor being constructed.
|
|
void | InitFromDescriptor (const RNTupleDescriptor &descriptor) |
| Initialize sink based on an existing descriptor and fill into the descriptor builder.
|
|
RPagePersistentSink & | operator= (const RPagePersistentSink &)=delete |
|
RPagePersistentSink & | operator= (RPagePersistentSink &&)=default |
|
RStagedCluster | StageCluster (NTupleSize_t nNewEntries) final |
| Stage the current cluster and create a new one for the following data.
|
|
void | UpdateExtraTypeInfo (const RExtraTypeInfoDescriptor &extraTypeInfo) final |
| Adds an extra type information record to schema.
|
|
void | UpdateSchema (const RNTupleModelChangeset &changeset, NTupleSize_t firstEntry) final |
| Incorporate incremental changes to the model into the ntuple descriptor.
|
|
| RPageSink (const RPageSink &)=delete |
|
| RPageSink (RPageSink &&)=default |
|
| RPageSink (std::string_view ntupleName, const RNTupleWriteOptions &options) |
|
| ~RPageSink () override |
|
virtual std::uint64_t | CommitCluster (NTupleSize_t nNewEntries) |
| Finalize the current cluster and create a new one for the following data.
|
|
void | CommitDataset () |
| Run the registered callbacks and finalize the current cluster and the entrire data set.
|
|
void | DropColumn (ColumnHandle_t) final |
| Unregisters a column.
|
|
virtual RSinkGuard | GetSinkGuard () |
|
EPageStorageType | GetType () final |
| Whether the concrete implementation is a sink or a source.
|
|
const RNTupleWriteOptions & | GetWriteOptions () const |
| Returns the sink's write options.
|
|
void | Init (RNTupleModel &model) |
| Physically creates the storage container to hold the ntuple (e.g., a keys a TFile or an S3 bucket) Init() associates column handles to the columns referenced by the model.
|
|
bool | IsInitialized () const |
|
RPageSink & | operator= (const RPageSink &)=delete |
|
RPageSink & | operator= (RPageSink &&)=default |
|
void | RegisterOnCommitDatasetCallback (Callback_t callback) |
| The registered callback is executed at the beginning of CommitDataset();.
|
|
virtual RPage | ReservePage (ColumnHandle_t columnHandle, std::size_t nElements) |
| Get a new, empty page for the given column that can be filled with up to nElements; nElements must be larger than zero.
|
|
| RPageStorage (const RPageStorage &other)=delete |
|
| RPageStorage (RPageStorage &&other)=default |
|
| RPageStorage (std::string_view name) |
|
virtual | ~RPageStorage () |
|
ColumnId_t | GetColumnId (ColumnHandle_t columnHandle) const |
|
virtual Detail::RNTupleMetrics & | GetMetrics () |
| Returns the default metrics object.
|
|
const std::string & | GetNTupleName () const |
| Returns the NTuple name.
|
|
RPageStorage & | operator= (const RPageStorage &other)=delete |
|
RPageStorage & | operator= (RPageStorage &&other)=default |
|
void | SetTaskScheduler (RTaskScheduler *taskScheduler) |
|
|
RNTupleLocator | CommitClusterGroupImpl (unsigned char *serializedPageList, std::uint32_t length) final |
| Returns the locator of the page list envelope of the given buffer that contains the serialized page list.
|
|
void | CommitDatasetImpl () final |
|
void | CommitDatasetImpl (unsigned char *serializedFooter, std::uint32_t length) final |
|
virtual void | CommitDatasetImpl (unsigned char *serializedFooter, std::uint32_t length)=0 |
|
RNTupleLocator | CommitPageImpl (ColumnHandle_t columnHandle, const RPage &page) final |
|
RNTupleLocator | CommitSealedPageImpl (DescriptorId_t physicalColumnId, const RPageStorage::RSealedPage &sealedPage) final |
|
std::vector< RNTupleLocator > | CommitSealedPageVImpl (std::span< RPageStorage::RSealedPageGroup > ranges, const std::vector< bool > &mask) final |
| Vector commit of preprocessed pages.
|
|
void | InitImpl (RNTupleModel &model) final |
| Updates the descriptor and calls InitImpl() that handles the backend-specific details (file, DAOS, etc.)
|
|
void | InitImpl (unsigned char *serializedHeader, std::uint32_t length) final |
|
virtual void | InitImpl (unsigned char *serializedHeader, std::uint32_t length)=0 |
|
std::uint64_t | StageClusterImpl () final |
| Returns the number of bytes written to storage (excluding metadata)
|
|
void | WriteNTupleAnchor () |
|
void | WriteNTupleFooter (const void *data, size_t nbytes, size_t lenFooter) |
|
void | WriteNTupleHeader (const void *data, size_t nbytes, size_t lenHeader) |
|
void | EnableDefaultMetrics (const std::string &prefix) |
| Enables the default set of metrics provided by RPageSink.
|
|
RSealedPage | SealPage (const RPage &page, const RColumnElementBase &element) |
| Helper for streaming a page.
|
|
void | WaitForAllTasks () |
|
Vector commit of preprocessed pages.
The ranges
array specifies a range of sealed pages to be committed for each column. The returned vector contains, in order, the RNTupleLocator for each page on each range in ranges
, i.e. the first N entries refer to the N pages in ranges[0]
, followed by M entries that refer to the M pages in ranges[1]
, etc. The mask allows to skip writing out certain pages. The vector has the size of all the pages. For every false
value in the mask, the corresponding locator is skipped (missing) in the output vector. The default is to call CommitSealedPageImpl
for each page; derived classes may provide an optimized implementation though.
Reimplemented from ROOT::Experimental::Internal::RPagePersistentSink.
Definition at line 358 of file RPageStorageDaos.cxx.