Package com.oracle.database.selectai.model

Class SyntheticDataBatchRequest

java.lang.Object
com.oracle.database.selectai.model.SyntheticDataBatchRequest
public final class SyntheticDataBatchRequest extends Object
Request object for generating synthetic data for multiple database objects.

A batch request groups multiple SyntheticDataObjectList descriptors together with shared SyntheticDataParams used for the synthetic data generation operation.

This model represents the batch form of DBMS_CLOUD_AI.GENERATE_SYNTHETIC_DATA, where target objects are sent through the object_list CLOB parameter and shared generation options are sent through the params CLOB parameter.

The SDK performs basic, deterministic validation where the constraint can be evaluated independently of Oracle Database. Each object descriptor must be non-null, and the batch must contain at least one object descriptor. Invalid values detected by the SDK result in an IllegalArgumentException.

Database-specific, database-version-specific, and other semantic validation is delegated to DBMS_CLOUD_AI and Oracle Database. Therefore, a batch request that passes SDK validation may still be rejected by the database based on the selected profile, object descriptors, generation parameters, or other database-side requirements.

See Also:

  • Method Details

    • getObjectListJson

      public String getObjectListJson()
      Returns the object descriptors serialized as a JSON array for DBMS_CLOUD_AI.GENERATE_SYNTHETIC_DATA.
      Returns:
      JSON array representing the batch object list
      Throws:
      IllegalStateException - if the object list cannot be serialized

    • getParamsJson

      public String getParamsJson()
      Returns the shared synthetic data generation parameters serialized as JSON.
      Returns:
      JSON representation of SyntheticDataParams, or null when no parameters are configured

    • getParams

      public SyntheticDataParams getParams()
      Returns the synthetic data generation parameters shared by the batch.
      Returns:
      generation parameters, or null when not set

    • getObjectList

      public List<SyntheticDataObjectList> getObjectList()
      Returns the target database object descriptors.
      Returns:
      immutable list of target object descriptors

    • builder

      public static SyntheticDataBatchRequest.Builder builder()
      Creates a builder for a batch synthetic-data request.
      Returns:
      new builder for constructing a batch request