BDS Common Types

DBMS_CLOUD_OCI_BDS_VARCHAR2_TBL Type

Nested table type of varchar2(32767).

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_varchar2_tbl FORCE IS TABLE OF (varchar2(32767)) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_ACTIVATE_BDS_METASTORE_CONFIGURATION_DETAILS_T Type

The reqeust body when activating a BDS metastore configuration

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_activate_bds_metastore_configuration_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  bds_api_key_passphrase varchar2(32767),
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_activate_bds_metastore_configuration_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_activate_bds_metastore_configuration_details_t (
    bds_api_key_passphrase varchar2,
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

bds_api_key_passphrase

(optional) Base-64 encoded passphrase of the BDS Api Key. Set only if metastore's type is EXTERNAL.

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

DBMS_CLOUD_OCI_BDS_ADD_AUTO_SCALE_POLICY_DETAILS_T Type

Policy definition for the autoscale configuration. An autoscaling policy is part of an autoscaling configuration. For more information, see Autoscaling You can create following type of autoscaling policies: - **MetricBasedVerticalScalingPolicy:** Vertical autoscaling action is triggered when a performance metric exceeds a threshold - **MetricBasedHorizontalScalingPolicy:** Horizontal autoscaling action is triggered when a performance metric exceeds a threshold - **ScheduleBasedVerticalScalingPolicy:** Vertical autoscaling action is triggered at the specific times that you schedule. - **ScheduleBasedHorizontalScalingPolicy:** Horizontal autoscaling action is triggered at the specific times that you schedule. An autoscaling configuration can have one of above supported policies.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_auto_scale_policy_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  policy_type varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_auto_scale_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_auto_scale_policy_details_t (
    policy_type varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE NOT FINAL;

Fields

Field Description

policy_type

(required) Type of autoscaling policy.

DBMS_CLOUD_OCI_BDS_METRIC_THRESHOLD_RULE_T Type

An autoscale action is triggered when a performance metric exceeds a threshold.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_metric_threshold_rule_t FORCE AUTHID CURRENT_USER IS OBJECT (
  duration_in_minutes number,
  operator varchar2(32767),
  value number,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_threshold_rule_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_threshold_rule_t (
    duration_in_minutes number,
    operator varchar2,
    value number
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

duration_in_minutes

(required) This value is the minimum period of time the metric value exceeds the threshold value before the action is triggered. The value is in minutes.

operator

(required) The comparison operator to use. Options are greater than (GT) or less than (LT).

Allowed values are: 'GT', 'LT'

value

(required) Integer non-negative value. 0 < value < 100

DBMS_CLOUD_OCI_BDS_AUTO_SCALE_POLICY_METRIC_RULE_T Type

Metric and threshold details for triggering an autoscale action.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t FORCE AUTHID CURRENT_USER IS OBJECT (
  metric_type varchar2(32767),
  threshold dbms_cloud_oci_bds_metric_threshold_rule_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t (
    metric_type varchar2,
    threshold dbms_cloud_oci_bds_metric_threshold_rule_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

metric_type

(required) Allowed value is CPU_UTILIZATION.

Allowed values are: 'CPU_UTILIZATION'

threshold

(required)

DBMS_CLOUD_OCI_BDS_AUTO_SCALE_POLICY_RULE_T Type

A rule that defines a specific autoscale action to take and the metric that triggers that action.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_auto_scale_policy_rule_t FORCE AUTHID CURRENT_USER IS OBJECT (
  action varchar2(32767),
  metric dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scale_policy_rule_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scale_policy_rule_t (
    action varchar2,
    metric dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

action

(required) The valid value are CHANGE_SHAPE_SCALE_UP or CHANGE_SHAPE_SCALE_DOWN.

Allowed values are: 'CHANGE_SHAPE_SCALE_UP', 'CHANGE_SHAPE_SCALE_DOWN'

metric

(required)

DBMS_CLOUD_OCI_BDS_AUTO_SCALE_POLICY_RULE_TBL Type

Nested table type of dbms_cloud_oci_bds_auto_scale_policy_rule_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_auto_scale_policy_rule_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_auto_scale_policy_rule_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_AUTO_SCALE_POLICY_T Type

This model for autoscaling policy is deprecated and not supported for ODH clusters. Use the `AutoScalePolicyDetails` model to manage autoscale policy details for ODH clusters.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_auto_scale_policy_t FORCE AUTHID CURRENT_USER IS OBJECT (
  policy_type varchar2(32767),
  rules dbms_cloud_oci_bds_auto_scale_policy_rule_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scale_policy_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scale_policy_t (
    policy_type varchar2,
    rules dbms_cloud_oci_bds_auto_scale_policy_rule_tbl
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

policy_type

(required) Types of autoscale policies. Options are SCHEDULE-BASED or THRESHOLD-BASED. (Only THRESHOLD-BASED is supported in this release.)

Allowed values are: 'THRESHOLD_BASED', 'SCHEDULE_BASED', 'NONE'

rules

(required) The list of rules for autoscaling. If an action has multiple rules, the last rule in the array will be applied.

DBMS_CLOUD_OCI_BDS_ADD_AUTO_SCALING_CONFIGURATION_DETAILS_T Type

The information about the autoscale configuration.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_auto_scaling_configuration_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  display_name varchar2(32767),
  node_type varchar2(32767),
  is_enabled number,
  cluster_admin_password varchar2(32767),
  policy dbms_cloud_oci_bds_auto_scale_policy_t,
  policy_details dbms_cloud_oci_bds_add_auto_scale_policy_details_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_auto_scaling_configuration_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_auto_scaling_configuration_details_t (
    display_name varchar2,
    node_type varchar2,
    is_enabled number,
    cluster_admin_password varchar2,
    policy dbms_cloud_oci_bds_auto_scale_policy_t,
    policy_details dbms_cloud_oci_bds_add_auto_scale_policy_details_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

display_name

(optional) A user-friendly name. The name does not have to be unique, and it may be changed. Avoid entering confidential information.

node_type

(required) A node type that is managed by an autoscale configuration. The only supported types are WORKER and COMPUTE_ONLY_WORKER.

is_enabled

(required) Whether the autoscale configuration is enabled.

cluster_admin_password

(required) Base-64 encoded password for the cluster (and Cloudera Manager) admin user.

policy

(optional)

policy_details

(optional)

DBMS_CLOUD_OCI_BDS_ADD_BLOCK_STORAGE_DETAILS_T Type

The information about added block volumes.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_block_storage_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  block_volume_size_in_g_bs number,
  node_type varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_block_storage_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_block_storage_details_t (
    cluster_admin_password varchar2,
    block_volume_size_in_g_bs number,
    node_type varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster (and Cloudera Manager) admin user.

block_volume_size_in_g_bs

(required) The size of block volume in GB to be added to each worker node. All the details needed for attaching the block volume are managed by service itself.

node_type

(required) Worker node types.

Allowed values are: 'WORKER', 'COMPUTE_ONLY_WORKER', 'KAFKA_BROKER'

DBMS_CLOUD_OCI_BDS_SHAPE_CONFIG_DETAILS_T Type

The shape configuration requested for the node.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_shape_config_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  ocpus number,
  memory_in_g_bs number,
  nvmes number,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_shape_config_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_shape_config_details_t (
    ocpus number,
    memory_in_g_bs number,
    nvmes number
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

ocpus

(optional) The total number of OCPUs available to the node.

memory_in_g_bs

(optional) The total amount of memory available to the node, in gigabytes.

nvmes

(optional) The number of NVMe drives to be used for storage. A single drive has 6.8 TB available.

DBMS_CLOUD_OCI_BDS_ADD_CLOUD_SQL_DETAILS_T Type

The information about the added Cloud SQL.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_cloud_sql_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  shape varchar2(32767),
  shape_config dbms_cloud_oci_bds_shape_config_details_t,
  block_volume_size_in_g_bs number,
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_cloud_sql_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_cloud_sql_details_t (
    shape varchar2,
    shape_config dbms_cloud_oci_bds_shape_config_details_t,
    block_volume_size_in_g_bs number,
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

shape

(required) Shape of the node.

shape_config

(optional)

block_volume_size_in_g_bs

(optional) The size of block volume in GB to be attached to the given node. All details needed for attaching the block volume are managed by the service itself.

cluster_admin_password

(required) Base-64 encoded password for the cluster (and Cloudera Manager) admin user.

DBMS_CLOUD_OCI_BDS_ADD_KAFKA_DETAILS_T Type

The information about the Kafka service to be added.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_kafka_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  shape varchar2(32767),
  number_of_kafka_nodes number,
  shape_config dbms_cloud_oci_bds_shape_config_details_t,
  block_volume_size_in_g_bs number,
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_kafka_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_kafka_details_t (
    shape varchar2,
    number_of_kafka_nodes number,
    shape_config dbms_cloud_oci_bds_shape_config_details_t,
    block_volume_size_in_g_bs number,
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

shape

(required) Shape of the Kafka broker node.

number_of_kafka_nodes

(required) Number of Kafka nodes for the cluster.

shape_config

(optional)

block_volume_size_in_g_bs

(optional) The size of block volme in GB to be attached to the given node. All details needed for attaching the block volume are managed by the service itself.

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

DBMS_CLOUD_OCI_BDS_ADD_MASTER_NODES_DETAILS_T Type

The information about added master nodes.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_master_nodes_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  number_of_master_nodes number,
  shape varchar2(32767),
  block_volume_size_in_g_bs number,
  shape_config dbms_cloud_oci_bds_shape_config_details_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_master_nodes_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_master_nodes_details_t (
    cluster_admin_password varchar2,
    number_of_master_nodes number,
    shape varchar2,
    block_volume_size_in_g_bs number,
    shape_config dbms_cloud_oci_bds_shape_config_details_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded Cluster Admin Password for cluster admin user.

number_of_master_nodes

(required) Number of additional master nodes for the cluster.

shape

(optional) Shape of the node. It's a read-only property derived from existing Master node.

block_volume_size_in_g_bs

(optional) The size of block volume in GB to be attached to the given node. It's a read-only property.

shape_config

(optional)

DBMS_CLOUD_OCI_BDS_METRIC_BASED_HORIZONTAL_SCALE_OUT_CONFIG_T Type

Configration for a metric based horizontal scale-out policy.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_metric_based_horizontal_scale_out_config_t FORCE AUTHID CURRENT_USER IS OBJECT (
  metric dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t,
  max_node_count number,
  step_size number,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_horizontal_scale_out_config_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_horizontal_scale_out_config_t (
    metric dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t,
    max_node_count number,
    step_size number
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

metric

(optional)

max_node_count

(optional) This value is the maximum number of nodes the cluster can be scaled-out to.

step_size

(optional) This value is the number of nodes to add during a scale-out event.

DBMS_CLOUD_OCI_BDS_METRIC_BASED_HORIZONTAL_SCALE_IN_CONFIG_T Type

Configration for a metric based horizontal scale-in policy.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_metric_based_horizontal_scale_in_config_t FORCE AUTHID CURRENT_USER IS OBJECT (
  metric dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t,
  min_node_count number,
  step_size number,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_horizontal_scale_in_config_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_horizontal_scale_in_config_t (
    metric dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t,
    min_node_count number,
    step_size number
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

metric

(optional)

min_node_count

(optional) This value is the minimum number of nodes the cluster can be scaled-in to.

step_size

(optional) This value is the number of nodes to remove during a scale-in event.

DBMS_CLOUD_OCI_BDS_ADD_METRIC_BASED_HORIZONTAL_SCALING_POLICY_DETAILS_T Type

Details of a metric based horizontal autoscaling policy. In a metric-based autoscaling policy, an autoscaling action is triggered when a performance metric exceeds a threshold.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_metric_based_horizontal_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_add_auto_scale_policy_details_t (
  scale_out_config dbms_cloud_oci_bds_metric_based_horizontal_scale_out_config_t,
  scale_in_config dbms_cloud_oci_bds_metric_based_horizontal_scale_in_config_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_metric_based_horizontal_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_metric_based_horizontal_scaling_policy_details_t (
    policy_type varchar2,
    scale_out_config dbms_cloud_oci_bds_metric_based_horizontal_scale_out_config_t,
    scale_in_config dbms_cloud_oci_bds_metric_based_horizontal_scale_in_config_t
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_add_metric_based_horizontal_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_add_auto_scale_policy_details_t type.

Fields

Field Description

scale_out_config

(optional)

scale_in_config

(optional)

DBMS_CLOUD_OCI_BDS_METRIC_BASED_VERTICAL_SCALE_UP_CONFIG_T Type

Configration for a metric based vertical scale-up policy.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_metric_based_vertical_scale_up_config_t FORCE AUTHID CURRENT_USER IS OBJECT (
  metric dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t,
  max_ocpus_per_node number,
  max_memory_per_node number,
  ocpu_step_size number,
  memory_step_size number,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_vertical_scale_up_config_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_vertical_scale_up_config_t (
    metric dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t,
    max_ocpus_per_node number,
    max_memory_per_node number,
    ocpu_step_size number,
    memory_step_size number
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

metric

(optional)

max_ocpus_per_node

(optional) For nodes with flexible compute shapes, this value is the maximum number of OCPUs each node can be scaled-up to. This value is not used for nodes with fixed compute shapes.

max_memory_per_node

(optional) For nodes with flexible compute shapes, this value is the maximum memory in GBs each node can be scaled-up to. This value is not used for nodes with fixed compute shapes.

ocpu_step_size

(optional) For nodes with flexible compute shapes, this value is the number of OCPUs to add to each node during a scale-up event. This value is not used for nodes with fixed compute shapes.

memory_step_size

(optional) For nodes with flexible compute shapes, this value is the size of memory in GBs to add to each node during a scale-up event. This value is not used for nodes with fixed compute shapes.

DBMS_CLOUD_OCI_BDS_METRIC_BASED_VERTICAL_SCALE_DOWN_CONFIG_T Type

Configration for a metric based vertical scale-down policy.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_metric_based_vertical_scale_down_config_t FORCE AUTHID CURRENT_USER IS OBJECT (
  metric dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t,
  min_ocpus_per_node number,
  min_memory_per_node number,
  ocpu_step_size number,
  memory_step_size number,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_vertical_scale_down_config_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_vertical_scale_down_config_t (
    metric dbms_cloud_oci_bds_auto_scale_policy_metric_rule_t,
    min_ocpus_per_node number,
    min_memory_per_node number,
    ocpu_step_size number,
    memory_step_size number
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

metric

(optional)

min_ocpus_per_node

(optional) For nodes with flexible compute shapes, this value is the minimum number of OCPUs each node can be scaled-down to. This value is not used for nodes with fixed compute shapes.

min_memory_per_node

(optional) For nodes with flexible compute shapes, this value is the minimum memory in GBs each node can be scaled-down to. This value is not used for nodes with fixed compute shapes.

ocpu_step_size

(optional) For nodes with flexible compute shapes, this value is the number of OCPUs to remove from each node during a scale-down event. This value is not used for nodes with fixed compute shapes.

memory_step_size

(optional) For nodes with flexible compute shapes, this value is the size of memory in GBs to remove from each node during a scale-down event. This value is not used for nodes with fixed compute shapes.

DBMS_CLOUD_OCI_BDS_ADD_METRIC_BASED_VERTICAL_SCALING_POLICY_DETAILS_T Type

Details of a metric based vertical autoscaling policy. In a metric-based autoscaling policy, an autoscaling action is triggered when a performance metric exceeds a threshold.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_metric_based_vertical_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_add_auto_scale_policy_details_t (
  scale_up_config dbms_cloud_oci_bds_metric_based_vertical_scale_up_config_t,
  scale_down_config dbms_cloud_oci_bds_metric_based_vertical_scale_down_config_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_metric_based_vertical_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_metric_based_vertical_scaling_policy_details_t (
    policy_type varchar2,
    scale_up_config dbms_cloud_oci_bds_metric_based_vertical_scale_up_config_t,
    scale_down_config dbms_cloud_oci_bds_metric_based_vertical_scale_down_config_t
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_add_metric_based_vertical_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_add_auto_scale_policy_details_t type.

Fields

Field Description

scale_up_config

(optional)

scale_down_config

(optional)

DBMS_CLOUD_OCI_BDS_HORIZONTAL_SCALING_SCHEDULE_DETAILS_T Type

Details of a horizontal scaling schedule.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_horizontal_scaling_schedule_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  schedule_type varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_horizontal_scaling_schedule_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_horizontal_scaling_schedule_details_t (
    schedule_type varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE NOT FINAL;

Fields

Field Description

schedule_type

(optional) The type of schedule.

DBMS_CLOUD_OCI_BDS_HORIZONTAL_SCALING_SCHEDULE_DETAILS_TBL Type

Nested table type of dbms_cloud_oci_bds_horizontal_scaling_schedule_details_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_horizontal_scaling_schedule_details_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_horizontal_scaling_schedule_details_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_ADD_SCHEDULE_BASED_HORIZONTAL_SCALING_POLICY_DETAILS_T Type

Details of a schedule based horizontal autoscaling policy. In a schedule-based autoscaling policy, an autoscaling action is triggered at the scheduled execution time.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_schedule_based_horizontal_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_add_auto_scale_policy_details_t (
  timezone varchar2(32767),
  schedule_details dbms_cloud_oci_bds_horizontal_scaling_schedule_details_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_schedule_based_horizontal_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_schedule_based_horizontal_scaling_policy_details_t (
    policy_type varchar2,
    timezone varchar2,
    schedule_details dbms_cloud_oci_bds_horizontal_scaling_schedule_details_tbl
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_add_schedule_based_horizontal_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_add_auto_scale_policy_details_t type.

Fields

Field Description

timezone

(optional) The time zone of the execution schedule, in IANA time zone database name format

schedule_details

(optional) Details of a horizontal scaling schedule.

DBMS_CLOUD_OCI_BDS_VERTICAL_SCALING_SCHEDULE_DETAILS_T Type

Details of a vertical scaling schedule.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_vertical_scaling_schedule_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  schedule_type varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_vertical_scaling_schedule_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_vertical_scaling_schedule_details_t (
    schedule_type varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE NOT FINAL;

Fields

Field Description

schedule_type

(optional) The type of schedule.

DBMS_CLOUD_OCI_BDS_VERTICAL_SCALING_SCHEDULE_DETAILS_TBL Type

Nested table type of dbms_cloud_oci_bds_vertical_scaling_schedule_details_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_vertical_scaling_schedule_details_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_vertical_scaling_schedule_details_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_ADD_SCHEDULE_BASED_VERTICAL_SCALING_POLICY_DETAILS_T Type

Details of a schedule based vertical autoscaling policy. In a schedule-based autoscaling policy, an autoscaling action is triggered at the scheduled execution time.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_schedule_based_vertical_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_add_auto_scale_policy_details_t (
  timezone varchar2(32767),
  schedule_details dbms_cloud_oci_bds_vertical_scaling_schedule_details_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_schedule_based_vertical_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_schedule_based_vertical_scaling_policy_details_t (
    policy_type varchar2,
    timezone varchar2,
    schedule_details dbms_cloud_oci_bds_vertical_scaling_schedule_details_tbl
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_add_schedule_based_vertical_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_add_auto_scale_policy_details_t type.

Fields

Field Description

timezone

(optional) The time zone of the execution schedule, in IANA time zone database name format

schedule_details

(optional) Details of a vertical scaling schedule.

DBMS_CLOUD_OCI_BDS_ADD_UTILITY_NODES_DETAILS_T Type

The information about added utility nodes.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_utility_nodes_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  number_of_utility_nodes number,
  shape varchar2(32767),
  block_volume_size_in_g_bs number,
  shape_config dbms_cloud_oci_bds_shape_config_details_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_utility_nodes_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_utility_nodes_details_t (
    cluster_admin_password varchar2,
    number_of_utility_nodes number,
    shape varchar2,
    block_volume_size_in_g_bs number,
    shape_config dbms_cloud_oci_bds_shape_config_details_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded Cluster Admin Password for cluster admin user.

number_of_utility_nodes

(required) Number of additional utility nodes for the cluster.

shape

(optional) Shape of the node. It's a read-only property derived from existing Utility node.

block_volume_size_in_g_bs

(optional) The size of block volume in GB to be attached to the given node. It's a read-only property.

shape_config

(optional)

DBMS_CLOUD_OCI_BDS_ADD_WORKER_NODES_DETAILS_T Type

The information about added nodes.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_add_worker_nodes_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  number_of_worker_nodes number,
  node_type varchar2(32767),
  shape varchar2(32767),
  block_volume_size_in_g_bs number,
  shape_config dbms_cloud_oci_bds_shape_config_details_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_worker_nodes_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_add_worker_nodes_details_t (
    cluster_admin_password varchar2,
    number_of_worker_nodes number,
    node_type varchar2,
    shape varchar2,
    block_volume_size_in_g_bs number,
    shape_config dbms_cloud_oci_bds_shape_config_details_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster (and Cloudera Manager) admin user.

number_of_worker_nodes

(required) Number of additional worker nodes for the cluster.

node_type

(required) Worker node types, can either be Worker Data node or Compute only worker node.

Allowed values are: 'WORKER', 'COMPUTE_ONLY_WORKER', 'EDGE', 'KAFKA_BROKER'

shape

(optional) Shape of the node. This has to be specified when adding compute only worker node at the first time. Otherwise, it's a read-only property.

block_volume_size_in_g_bs

(optional) The size of block volume in GB to be attached to the given node. This has to be specified when adding compute only worker node at the first time. Otherwise, it's a read-only property.

shape_config

(optional)

DBMS_CLOUD_OCI_BDS_AUTO_SCALE_POLICY_DETAILS_T Type

Details of an autoscale policy. You can create following types of autoscaling policies: - **MetricBasedVerticalScalingPolicy:** Vertical autoscaling action is triggered when a performance metric exceeds a threshold - **MetricBasedHorizontalScalingPolicy:** Horizontal autoscaling action is triggered when a performance metric exceeds a threshold - **ScheduleBasedVerticalScalingPolicy:** Vertical autoscaling action is triggered at the specific times that you schedule. - **ScheduleBasedHorizontalScalingPolicy:** Horizontal autoscaling action is triggered at the specific times that you schedule.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_auto_scale_policy_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  policy_type varchar2(32767),
  trigger_type varchar2(32767),
  action_type varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scale_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scale_policy_details_t (
    policy_type varchar2,
    trigger_type varchar2,
    action_type varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE NOT FINAL;

Fields

Field Description

policy_type

(required) Type of autoscaling policy.

Allowed values are: 'METRIC_BASED_VERTICAL_SCALING_POLICY', 'METRIC_BASED_HORIZONTAL_SCALING_POLICY', 'SCHEDULE_BASED_VERTICAL_SCALING_POLICY', 'SCHEDULE_BASED_HORIZONTAL_SCALING_POLICY'

trigger_type

(required) The type of autoscaling trigger.

Allowed values are: 'METRIC_BASED', 'SCHEDULE_BASED'

action_type

(required) The type of autoscaling action to take.

Allowed values are: 'VERTICAL_SCALING', 'HORIZONTAL_SCALING'

DBMS_CLOUD_OCI_BDS_AUTO_SCALING_CONFIGURATION_T Type

The information about the autoscale configuration.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_auto_scaling_configuration_t FORCE AUTHID CURRENT_USER IS OBJECT (
  id varchar2(32767),
  display_name varchar2(32767),
  node_type varchar2(32767),
  lifecycle_state varchar2(32767),
  time_created timestamp with time zone,
  time_updated timestamp with time zone,
  policy dbms_cloud_oci_bds_auto_scale_policy_t,
  policy_details dbms_cloud_oci_bds_auto_scale_policy_details_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scaling_configuration_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scaling_configuration_t (
    id varchar2,
    display_name varchar2,
    node_type varchar2,
    lifecycle_state varchar2,
    time_created timestamp with time zone,
    time_updated timestamp with time zone,
    policy dbms_cloud_oci_bds_auto_scale_policy_t,
    policy_details dbms_cloud_oci_bds_auto_scale_policy_details_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

id

(required) The unique identifier for the autoscale configuration.

display_name

(required) A user-friendly name. The name does not have to be unique, and it may be changed. Avoid entering confidential information.

node_type

(required) A node type that is managed by an autoscale configuration. The only supported types are WORKER and COMPUTE_ONLY_WORKER.

lifecycle_state

(required) The state of the autoscale configuration.

Allowed values are: 'CREATING', 'ACTIVE', 'INACTIVE', 'UPDATING', 'DELETING', 'DELETED', 'FAILED'

time_created

(required) The time the cluster was created, shown as an RFC 3339 formatted datetime string.

time_updated

(required) The time the autoscale configuration was updated, shown as an RFC 3339 formatted datetime string.

policy

(required)

policy_details

(optional)

DBMS_CLOUD_OCI_BDS_AUTO_SCALING_CONFIGURATION_SUMMARY_T Type

The information about the autoscale configuration.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_auto_scaling_configuration_summary_t FORCE AUTHID CURRENT_USER IS OBJECT (
  id varchar2(32767),
  display_name varchar2(32767),
  lifecycle_state varchar2(32767),
  node_type varchar2(32767),
  time_created timestamp with time zone,
  time_updated timestamp with time zone,
  policy dbms_cloud_oci_bds_auto_scale_policy_t,
  policy_details dbms_cloud_oci_bds_auto_scale_policy_details_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scaling_configuration_summary_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_auto_scaling_configuration_summary_t (
    id varchar2,
    display_name varchar2,
    lifecycle_state varchar2,
    node_type varchar2,
    time_created timestamp with time zone,
    time_updated timestamp with time zone,
    policy dbms_cloud_oci_bds_auto_scale_policy_t,
    policy_details dbms_cloud_oci_bds_auto_scale_policy_details_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

id

(required) The OCID of the autoscale configuration.

display_name

(required) A user-friendly name. The name does not have to be unique, and it may be changed. Avoid entering confidential information.

lifecycle_state

(required) The state of the autoscale configuration.

node_type

(required) A node type that is managed by an autoscale configuration. The only supported types are WORKER and COMPUTE_ONLY_WORKER.

time_created

(required) The time the cluster was created, shown as an RFC 3339 formatted datetime string.

time_updated

(required) The time the autoscale configuration was updated, shown as an RFC 3339 formatted datetime string.

policy

(required)

policy_details

(optional)

DBMS_CLOUD_OCI_BDS_BDS_API_KEY_T Type

The API key information.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_bds_api_key_t FORCE AUTHID CURRENT_USER IS OBJECT (
  id varchar2(32767),
  user_id varchar2(32767),
  key_alias varchar2(32767),
  default_region varchar2(32767),
  tenant_id varchar2(32767),
  fingerprint varchar2(32767),
  pemfilepath varchar2(32767),
  time_created timestamp with time zone,
  lifecycle_state varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_api_key_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_api_key_t (
    id varchar2,
    user_id varchar2,
    key_alias varchar2,
    default_region varchar2,
    tenant_id varchar2,
    fingerprint varchar2,
    pemfilepath varchar2,
    time_created timestamp with time zone,
    lifecycle_state varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

id

(required) Identifier of the user's API key.

user_id

(required) The user OCID for which this API key was created.

key_alias

(required) User friendly identifier used to uniquely differentiate between different API keys. Only ASCII alphanumeric characters with no spaces allowed.

default_region

(required) The name of the region to establish the Object Storage endpoint. Example us-phoenix-1 .

tenant_id

(required) The OCID of your tenancy.

fingerprint

(required) The fingerprint that corresponds to the public API key requested.

pemfilepath

(required) The full path and file name of the private key used for authentication. This location will be automatically selected on the BDS local file system.

time_created

(optional) The time the API key was created, shown as an RFC 3339 formatted datetime string.

lifecycle_state

(required) The state of the key.

Allowed values are: 'CREATING', 'ACTIVE', 'DELETING', 'DELETED', 'FAILED'

DBMS_CLOUD_OCI_BDS_BDS_API_KEY_SUMMARY_T Type

The API key summary.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_bds_api_key_summary_t FORCE AUTHID CURRENT_USER IS OBJECT (
  id varchar2(32767),
  key_alias varchar2(32767),
  lifecycle_state varchar2(32767),
  default_region varchar2(32767),
  time_created timestamp with time zone,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_api_key_summary_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_api_key_summary_t (
    id varchar2,
    key_alias varchar2,
    lifecycle_state varchar2,
    default_region varchar2,
    time_created timestamp with time zone
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

id

(required) Identifier of the user's API key.

key_alias

(required) User friendly identifier used to uniquely differentiate between different API keys. Only ASCII alphanumeric characters with no spaces allowed.

lifecycle_state

(required) The current status of the API key.

default_region

(required) The name of the region to establish the Object Storage endpoint which was set as part of key creation operation. If no region was provided this will be set to be the same region where the cluster lives. Example us-phoenix-1 .

time_created

(required) The time the API key was created, shown as an RFC 3339 formatted datetime string.

DBMS_CLOUD_OCI_BDS_NETWORK_CONFIG_T Type

Additional configuration of the user's network.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_network_config_t FORCE AUTHID CURRENT_USER IS OBJECT (
  is_nat_gateway_required number,
  cidr_block varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_network_config_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_network_config_t (
    is_nat_gateway_required number,
    cidr_block varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

is_nat_gateway_required

(optional) A boolean flag whether to configure a NAT gateway.

cidr_block

(optional) The CIDR IP address block of the VCN.

DBMS_CLOUD_OCI_BDS_CLUSTER_DETAILS_T Type

Specific info about a Hadoop cluster

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_cluster_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  bda_version varchar2(32767),
  bdm_version varchar2(32767),
  bds_version varchar2(32767),
  os_version varchar2(32767),
  db_version varchar2(32767),
  bd_cell_version varchar2(32767),
  csql_cell_version varchar2(32767),
  time_created timestamp with time zone,
  time_refreshed timestamp with time zone,
  cloudera_manager_url varchar2(32767),
  ambari_url varchar2(32767),
  big_data_manager_url varchar2(32767),
  hue_server_url varchar2(32767),
  odh_version varchar2(32767),
  jupyter_hub_url varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_cluster_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_cluster_details_t (
    bda_version varchar2,
    bdm_version varchar2,
    bds_version varchar2,
    os_version varchar2,
    db_version varchar2,
    bd_cell_version varchar2,
    csql_cell_version varchar2,
    time_created timestamp with time zone,
    time_refreshed timestamp with time zone,
    cloudera_manager_url varchar2,
    ambari_url varchar2,
    big_data_manager_url varchar2,
    hue_server_url varchar2,
    odh_version varchar2,
    jupyter_hub_url varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

bda_version

(optional) BDA version installed in the cluster

bdm_version

(optional) Big Data Manager version installed in the cluster.

bds_version

(optional) Big Data Service version installed in the cluster.

os_version

(optional) Oracle Linux version installed in the cluster.

db_version

(optional) Cloud SQL query server database version.

bd_cell_version

(optional) Cloud SQL cell version.

csql_cell_version

(optional) Big Data SQL version.

time_created

(required) The time the cluster was created, shown as an RFC 3339 formatted datetime string.

time_refreshed

(optional) The time the cluster was automatically or manually refreshed, shown as an RFC 3339 formatted datetime string.

cloudera_manager_url

(optional) The URL of Cloudera Manager

ambari_url

(optional) The URL of Ambari

big_data_manager_url

(optional) The URL of Big Data Manager.

hue_server_url

(optional) The URL of the Hue server.

odh_version

(optional) Version of the ODH (Oracle Distribution including Apache Hadoop) installed on the cluster.

jupyter_hub_url

(optional) The URL of the Jupyterhub.

DBMS_CLOUD_OCI_BDS_VOLUME_ATTACHMENT_DETAIL_T Type

A detail of the attached block volume.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_volume_attachment_detail_t FORCE AUTHID CURRENT_USER IS OBJECT (
  volume_attachment_id varchar2(32767),
  volume_size_in_g_bs number,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_volume_attachment_detail_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_volume_attachment_detail_t (
    volume_attachment_id varchar2,
    volume_size_in_g_bs number
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

volume_attachment_id

(required) The OCID of the volume attachment.

volume_size_in_g_bs

(required) The size of the volume in GBs.

DBMS_CLOUD_OCI_BDS_VOLUME_ATTACHMENT_DETAIL_TBL Type

Nested table type of dbms_cloud_oci_bds_volume_attachment_detail_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_volume_attachment_detail_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_volume_attachment_detail_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_NODE_T Type

Details about a node.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_node_t FORCE AUTHID CURRENT_USER IS OBJECT (
  instance_id varchar2(32767),
  display_name varchar2(32767),
  lifecycle_state varchar2(32767),
  node_type varchar2(32767),
  shape varchar2(32767),
  attached_block_volumes dbms_cloud_oci_bds_volume_attachment_detail_tbl,
  subnet_id varchar2(32767),
  ip_address varchar2(32767),
  hostname varchar2(32767),
  image_id varchar2(32767),
  ssh_fingerprint varchar2(32767),
  availability_domain varchar2(32767),
  fault_domain varchar2(32767),
  time_created timestamp with time zone,
  time_updated timestamp with time zone,
  ocpus number,
  memory_in_g_bs number,
  nvmes number,
  local_disks_total_size_in_g_bs number,
  time_maintenance_reboot_due timestamp with time zone,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_node_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_node_t (
    instance_id varchar2,
    display_name varchar2,
    lifecycle_state varchar2,
    node_type varchar2,
    shape varchar2,
    attached_block_volumes dbms_cloud_oci_bds_volume_attachment_detail_tbl,
    subnet_id varchar2,
    ip_address varchar2,
    hostname varchar2,
    image_id varchar2,
    ssh_fingerprint varchar2,
    availability_domain varchar2,
    fault_domain varchar2,
    time_created timestamp with time zone,
    time_updated timestamp with time zone,
    ocpus number,
    memory_in_g_bs number,
    nvmes number,
    local_disks_total_size_in_g_bs number,
    time_maintenance_reboot_due timestamp with time zone
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

instance_id

(required) The OCID of the underlying Oracle Cloud Infrastructure Compute instance.

display_name

(required) The name of the node.

lifecycle_state

(required) The state of the node.

Allowed values are: 'CREATING', 'ACTIVE', 'INACTIVE', 'UPDATING', 'DELETING', 'DELETED', 'FAILED', 'STOPPED', 'STOPPING', 'STARTING'

node_type

(required) Cluster node type.

Allowed values are: 'MASTER', 'EDGE', 'UTILITY', 'WORKER', 'COMPUTE_ONLY_WORKER', 'KAFKA_BROKER', 'BURSTING', 'CLOUD_SQL'

shape

(required) Shape of the node.

attached_block_volumes

(optional) The list of block volumes attached to a given node.

subnet_id

(required) The OCID of the subnet in which the node is to be created.

ip_address

(required) IP address of the node.

hostname

(optional) The fully-qualified hostname (FQDN) of the node.

image_id

(optional) The OCID of the image from which the node was created.

ssh_fingerprint

(required) The fingerprint of the SSH key used for node access.

availability_domain

(required) The name of the availability domain in which the node is running.

fault_domain

(required) The name of the fault domain in which the node is running.

time_created

(required) The time the node was created, shown as an RFC 3339 formatted datetime string.

time_updated

(optional) The time the cluster was updated, shown as an RFC 3339 formatted datetime string.

ocpus

(optional) The total number of OCPUs available to the node.

memory_in_g_bs

(optional) The total amount of memory available to the node, in gigabytes.

nvmes

(optional) The number of NVMe drives to be used for storage. A single drive has 6.8 TB available.

local_disks_total_size_in_g_bs

(optional) The aggregate size of all local disks, in gigabytes. If the instance does not have any local disks, this field is null.

time_maintenance_reboot_due

(optional) The date and time the instance is expected to be stopped / started, in the format defined by RFC3339.

DBMS_CLOUD_OCI_BDS_KERBEROS_DETAILS_T Type

Details about the Kerberos principals.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_kerberos_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  principal_name varchar2(32767),
  keytab_file varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_kerberos_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_kerberos_details_t (
    principal_name varchar2,
    keytab_file varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

principal_name

(required) Name of the Kerberos principal.

keytab_file

(required) Location of the keytab file

DBMS_CLOUD_OCI_BDS_KERBEROS_DETAILS_TBL Type

Nested table type of dbms_cloud_oci_bds_kerberos_details_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_kerberos_details_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_kerberos_details_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_CLOUD_SQL_DETAILS_T Type

The information about added Cloud SQL capability

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_cloud_sql_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  shape varchar2(32767),
  block_volume_size_in_g_bs number,
  is_kerberos_mapped_to_database_users number,
  ip_address varchar2(32767),
  kerberos_details dbms_cloud_oci_bds_kerberos_details_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_cloud_sql_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_cloud_sql_details_t (
    shape varchar2,
    block_volume_size_in_g_bs number,
    is_kerberos_mapped_to_database_users number,
    ip_address varchar2,
    kerberos_details dbms_cloud_oci_bds_kerberos_details_tbl
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

shape

(required) Shape of the node

block_volume_size_in_g_bs

(optional) The size of block volume in GB that needs to be attached to a given node. All the necessary details needed for attachment are managed by service itself.

is_kerberos_mapped_to_database_users

(optional) Boolean flag specifying whether or not Kerberos principals are mapped to database users.

ip_address

(required) IP address of the Cloud SQL node.

kerberos_details

(optional) Details about the Kerberos principals.

DBMS_CLOUD_OCI_BDS_NODE_TBL Type

Nested table type of dbms_cloud_oci_bds_node_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_node_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_node_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_BDS_INSTANCE_T Type

Description of the cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_bds_instance_t FORCE AUTHID CURRENT_USER IS OBJECT (
  id varchar2(32767),
  compartment_id varchar2(32767),
  display_name varchar2(32767),
  lifecycle_state varchar2(32767),
  cluster_version varchar2(32767),
  is_high_availability number,
  is_secure number,
  is_cloud_sql_configured number,
  is_kafka_configured number,
  network_config dbms_cloud_oci_bds_network_config_t,
  cluster_details dbms_cloud_oci_bds_cluster_details_t,
  nodes dbms_cloud_oci_bds_node_tbl,
  cloud_sql_details dbms_cloud_oci_bds_cloud_sql_details_t,
  created_by varchar2(32767),
  time_created timestamp with time zone,
  time_updated timestamp with time zone,
  number_of_nodes number,
  number_of_nodes_requiring_maintenance_reboot number,
  bootstrap_script_url varchar2(32767),
  freeform_tags json_element_t,
  defined_tags json_element_t,
  kms_key_id varchar2(32767),
  cluster_profile varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_instance_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_instance_t (
    id varchar2,
    compartment_id varchar2,
    display_name varchar2,
    lifecycle_state varchar2,
    cluster_version varchar2,
    is_high_availability number,
    is_secure number,
    is_cloud_sql_configured number,
    is_kafka_configured number,
    network_config dbms_cloud_oci_bds_network_config_t,
    cluster_details dbms_cloud_oci_bds_cluster_details_t,
    nodes dbms_cloud_oci_bds_node_tbl,
    cloud_sql_details dbms_cloud_oci_bds_cloud_sql_details_t,
    created_by varchar2,
    time_created timestamp with time zone,
    time_updated timestamp with time zone,
    number_of_nodes number,
    number_of_nodes_requiring_maintenance_reboot number,
    bootstrap_script_url varchar2,
    freeform_tags json_element_t,
    defined_tags json_element_t,
    kms_key_id varchar2,
    cluster_profile varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

id

(required) The OCID of the Big Data Service resource.

compartment_id

(required) The OCID of the compartment.

display_name

(required) The name of the cluster.

lifecycle_state

(required) The state of the cluster.

Allowed values are: 'CREATING', 'ACTIVE', 'UPDATING', 'SUSPENDING', 'SUSPENDED', 'RESUMING', 'DELETING', 'DELETED', 'FAILED', 'INACTIVE'

cluster_version

(optional) Version of the Hadoop distribution.

Allowed values are: 'CDH5', 'CDH6', 'ODH1', 'ODH0_9', 'ODH2_0'

is_high_availability

(required) Boolean flag specifying whether or not the cluster is highly available (HA)

is_secure

(required) Boolean flag specifying whether or not the cluster should be set up as secure.

is_cloud_sql_configured

(required) Boolean flag specifying whether or not Cloud SQL should be configured.

is_kafka_configured

(required) Boolean flag specifying whether or not Kafka should be configured.

network_config

(optional)

cluster_details

(optional)

nodes

(required) The list of nodes in the cluster.

cloud_sql_details

(optional)

created_by

(optional) The user who created the cluster.

time_created

(optional) The time the cluster was created, shown as an RFC 3339 formatted datetime string.

time_updated

(optional) The time the cluster was updated, shown as an RFC 3339 formatted datetime string.

number_of_nodes

(required) Number of nodes that forming the cluster

number_of_nodes_requiring_maintenance_reboot

(optional) Number of nodes that require a maintenance reboot

bootstrap_script_url

(optional) pre-authenticated URL of the bootstrap script in Object Store that can be downloaded and executed.

freeform_tags

(optional) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. For example, `{\"bar-key\": \"value\"}`

defined_tags

(optional) Defined tags for this resource. Each key is predefined and scoped to a namespace. For example, `{\"foo-namespace\": {\"bar-key\": \"value\"}}`

kms_key_id

(optional) The OCID of the Key Management master encryption key.

cluster_profile

(optional) Profile of the Big Data Service cluster.

Allowed values are: 'HADOOP_EXTENDED', 'HADOOP', 'HIVE', 'SPARK', 'HBASE', 'TRINO', 'KAFKA'

DBMS_CLOUD_OCI_BDS_BDS_INSTANCE_SUMMARY_T Type

Summary details of the Big Data Service cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_bds_instance_summary_t FORCE AUTHID CURRENT_USER IS OBJECT (
  id varchar2(32767),
  compartment_id varchar2(32767),
  display_name varchar2(32767),
  lifecycle_state varchar2(32767),
  number_of_nodes number,
  number_of_nodes_requiring_maintenance_reboot number,
  cluster_version varchar2(32767),
  is_high_availability number,
  is_secure number,
  is_cloud_sql_configured number,
  is_kafka_configured number,
  cluster_profile varchar2(32767),
  time_created timestamp with time zone,
  freeform_tags json_element_t,
  defined_tags json_element_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_instance_summary_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_instance_summary_t (
    id varchar2,
    compartment_id varchar2,
    display_name varchar2,
    lifecycle_state varchar2,
    number_of_nodes number,
    number_of_nodes_requiring_maintenance_reboot number,
    cluster_version varchar2,
    is_high_availability number,
    is_secure number,
    is_cloud_sql_configured number,
    is_kafka_configured number,
    cluster_profile varchar2,
    time_created timestamp with time zone,
    freeform_tags json_element_t,
    defined_tags json_element_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

id

(required) The OCID of the Big Data Service resource.

compartment_id

(required) The OCID of the compartment.

display_name

(required) The name of the cluster.

lifecycle_state

(required) The state of the cluster.

number_of_nodes

(required) The number of nodes that form the cluster.

number_of_nodes_requiring_maintenance_reboot

(optional) Number of nodes that require a maintenance reboot

cluster_version

(optional) Version of the Hadoop distribution.

is_high_availability

(required) Boolean flag specifying whether or not the cluster is highly available(HA).

is_secure

(required) Boolean flag specifying whether or not the cluster should be set up as secure.

is_cloud_sql_configured

(required) Boolean flag specifying whether Cloud SQL is configured or not.

is_kafka_configured

(required) Boolean flag specifying whether Kafka is configured or not.

cluster_profile

(optional) Profile of the Big Data Service cluster.

time_created

(required) The time the cluster was created, shown as an RFC 3339 formatted datetime string.

freeform_tags

(optional) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. For example, `{\"bar-key\": \"value\"}`

defined_tags

(optional) Defined tags for this resource. Each key is predefined and scoped to a namespace. For example, `{\"foo-namespace\": {\"bar-key\": \"value\"}}`

DBMS_CLOUD_OCI_BDS_BDS_METASTORE_CONFIGURATION_T Type

The metastore configuration information.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_bds_metastore_configuration_t FORCE AUTHID CURRENT_USER IS OBJECT (
  id varchar2(32767),
  display_name varchar2(32767),
  metastore_type varchar2(32767),
  metastore_id varchar2(32767),
  bds_api_key_id varchar2(32767),
  lifecycle_state varchar2(32767),
  time_created timestamp with time zone,
  time_updated timestamp with time zone,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_metastore_configuration_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_metastore_configuration_t (
    id varchar2,
    display_name varchar2,
    metastore_type varchar2,
    metastore_id varchar2,
    bds_api_key_id varchar2,
    lifecycle_state varchar2,
    time_created timestamp with time zone,
    time_updated timestamp with time zone
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

id

(required) The ID of the metastore configuration

display_name

(required) The display name of metastore configuration

metastore_type

(required) The type of the metastore in the metastore configuration.

Allowed values are: 'LOCAL', 'EXTERNAL'

metastore_id

(optional) The OCID of the Data Catalog metastore. Set only if metastore's type is EXTERNAL.

bds_api_key_id

(optional) The ID of BDS API Key used for metastore configuration. Set only if metastore's type is EXTERNAL.

lifecycle_state

(required) the lifecycle state of the metastore configuration.

Allowed values are: 'CREATING', 'ACTIVATING', 'ACTIVE', 'INACTIVE', 'UPDATING', 'FAILED', 'DELETING', 'DELETED'

time_created

(required) The time when the configuration was created, shown as an RFC 3339 formatted datetime string.

time_updated

(optional) The time when the configuration was updated, shown as an RFC 3339 formatted datetime string.

DBMS_CLOUD_OCI_BDS_BDS_METASTORE_CONFIGURATION_SUMMARY_T Type

The summary of metastore configuration information.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_bds_metastore_configuration_summary_t FORCE AUTHID CURRENT_USER IS OBJECT (
  id varchar2(32767),
  display_name varchar2(32767),
  metastore_type varchar2(32767),
  metastore_id varchar2(32767),
  bds_api_key_id varchar2(32767),
  lifecycle_state varchar2(32767),
  time_created timestamp with time zone,
  time_updated timestamp with time zone,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_metastore_configuration_summary_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_bds_metastore_configuration_summary_t (
    id varchar2,
    display_name varchar2,
    metastore_type varchar2,
    metastore_id varchar2,
    bds_api_key_id varchar2,
    lifecycle_state varchar2,
    time_created timestamp with time zone,
    time_updated timestamp with time zone
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

id

(required) The ID of the metastore configuration

display_name

(required) The display name of metastore configuration

metastore_type

(required) The type of the metastore in the metastore configuration.

metastore_id

(optional) The OCID of the Data Catalog metastore. Set only if metastore's type is EXTERNAL.

bds_api_key_id

(optional) The ID of BDS API Key used for metastore configuration. Set only if metastore's type is EXTERNAL.

lifecycle_state

(required) the lifecycle state of the metastore configuration.

time_created

(required) The time when the configuration was created, shown as an RFC 3339 formatted datetime string.

time_updated

(optional) The time when the configuration was updated, shown as an RFC 3339 formatted datetime string.

DBMS_CLOUD_OCI_BDS_CERTIFICATE_SERVICE_INFO_DETAILS_T Type

Details for certificate service info

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_certificate_service_info_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  services dbms_cloud_oci_bds_varchar2_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_certificate_service_info_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_certificate_service_info_details_t (
    services dbms_cloud_oci_bds_varchar2_tbl
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

services

(required) List of services for which TLS/SSL needs to be enabled.

DBMS_CLOUD_OCI_BDS_HOST_SPECIFIC_CERTIFICATE_DETAILS_T Type

Host specific certificate details

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_host_specific_certificate_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  host_name varchar2(32767),
  certificate_type varchar2(32767),
  time_expiry timestamp with time zone,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_host_specific_certificate_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_host_specific_certificate_details_t (
    host_name varchar2,
    certificate_type varchar2,
    time_expiry timestamp with time zone
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

host_name

(optional) Name of the host.

certificate_type

(optional) Type of certificate self signed or CA signed

Allowed values are: 'CUSTOM_SIGNED', 'SELF_SIGNED'

time_expiry

(optional) The time the certificate expires, shown as an RFC 3339 formatted datetime string.

DBMS_CLOUD_OCI_BDS_HOST_SPECIFIC_CERTIFICATE_DETAILS_TBL Type

Nested table type of dbms_cloud_oci_bds_host_specific_certificate_details_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_host_specific_certificate_details_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_host_specific_certificate_details_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_CERTIFICATE_SERVICE_INFO_SUMMARY_T Type

List of TLS/SSL information of services

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_certificate_service_info_summary_t FORCE AUTHID CURRENT_USER IS OBJECT (
  service varchar2(32767),
  service_certificate_status varchar2(32767),
  host_specific_certificate_details dbms_cloud_oci_bds_host_specific_certificate_details_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_certificate_service_info_summary_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_certificate_service_info_summary_t (
    service varchar2,
    service_certificate_status varchar2,
    host_specific_certificate_details dbms_cloud_oci_bds_host_specific_certificate_details_tbl
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

service

(required) Name of the service

Allowed values are: 'ZOOKEEPER', 'AMS', 'HDFS', 'YARN', 'MAPREDUCE', 'OOZIE', 'HBASE', 'SPARK', 'HIVE', 'KAFKA', 'FLINK', 'REGISTRY'

service_certificate_status

(required) Whether certificate is enabled or disabled

Allowed values are: 'ENABLED', 'DISABLED'

host_specific_certificate_details

(required) List of Host specific certificate details

DBMS_CLOUD_OCI_BDS_CHANGE_BDS_INSTANCE_COMPARTMENT_DETAILS_T Type

Move a Cluster to a Different Compartment

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_change_bds_instance_compartment_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  compartment_id varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_change_bds_instance_compartment_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_change_bds_instance_compartment_details_t (
    compartment_id varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

compartment_id

(required) The OCID of the compartment.

DBMS_CLOUD_OCI_BDS_CHANGE_SHAPE_NODES_T Type

Individual worker nodes groups details.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_change_shape_nodes_t FORCE AUTHID CURRENT_USER IS OBJECT (
  worker varchar2(32767),
  worker_shape_config dbms_cloud_oci_bds_shape_config_details_t,
  compute_only_worker varchar2(32767),
  compute_only_worker_shape_config dbms_cloud_oci_bds_shape_config_details_t,
  master varchar2(32767),
  master_shape_config dbms_cloud_oci_bds_shape_config_details_t,
  utility varchar2(32767),
  utility_shape_config dbms_cloud_oci_bds_shape_config_details_t,
  cloudsql varchar2(32767),
  cloudsql_shape_config dbms_cloud_oci_bds_shape_config_details_t,
  edge varchar2(32767),
  edge_shape_config dbms_cloud_oci_bds_shape_config_details_t,
  kafka_broker varchar2(32767),
  kafka_broker_shape_config dbms_cloud_oci_bds_shape_config_details_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_change_shape_nodes_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_change_shape_nodes_t (
    worker varchar2,
    worker_shape_config dbms_cloud_oci_bds_shape_config_details_t,
    compute_only_worker varchar2,
    compute_only_worker_shape_config dbms_cloud_oci_bds_shape_config_details_t,
    master varchar2,
    master_shape_config dbms_cloud_oci_bds_shape_config_details_t,
    utility varchar2,
    utility_shape_config dbms_cloud_oci_bds_shape_config_details_t,
    cloudsql varchar2,
    cloudsql_shape_config dbms_cloud_oci_bds_shape_config_details_t,
    edge varchar2,
    edge_shape_config dbms_cloud_oci_bds_shape_config_details_t,
    kafka_broker varchar2,
    kafka_broker_shape_config dbms_cloud_oci_bds_shape_config_details_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

worker

(optional) Change shape of worker nodes to the desired target shape. Both VM_STANDARD and E4 Flex shapes are allowed here.

worker_shape_config

(optional)

compute_only_worker

(optional) Change shape of compute only worker nodes to the desired target shape. Both VM_STANDARD and E4 Flex shapes are allowed here.

compute_only_worker_shape_config

(optional)

master

(optional) Change shape of master nodes to the desired target shape. Both VM_STANDARD and E4 Flex shapes are allowed here.

master_shape_config

(optional)

utility

(optional) Change shape of utility nodes to the desired target shape. Both VM_STANDARD and E4 Flex shapes are allowed here.

utility_shape_config

(optional)

cloudsql

(optional) Change shape of the Cloud SQL node to the desired target shape. Both VM_STANDARD and E4 Flex shapes are allowed here.

cloudsql_shape_config

(optional)

edge

(optional) Change shape of edge nodes to the desired target shape. Both VM_STANDARD and E4 Flex shapes are allowed here.

edge_shape_config

(optional)

kafka_broker

(optional) Change shape of Kafka Broker nodes to the desired target shape. Both VM_STANDARD and E4 Flex shapes are allowed here.

kafka_broker_shape_config

(optional)

DBMS_CLOUD_OCI_BDS_CHANGE_SHAPE_DETAILS_T Type

Resize details specified for individual nodes.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_change_shape_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  nodes dbms_cloud_oci_bds_change_shape_nodes_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_change_shape_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_change_shape_details_t (
    cluster_admin_password varchar2,
    nodes dbms_cloud_oci_bds_change_shape_nodes_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster (and Cloudera Manager) admin user.

nodes

(required)

DBMS_CLOUD_OCI_BDS_CREATE_BDS_API_KEY_DETAILS_T Type

API key created on user's behalf.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_create_bds_api_key_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  user_id varchar2(32767),
  passphrase varchar2(32767),
  default_region varchar2(32767),
  key_alias varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_create_bds_api_key_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_create_bds_api_key_details_t (
    user_id varchar2,
    passphrase varchar2,
    default_region varchar2,
    key_alias varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

user_id

(required) The OCID of the user for whom this new generated API key pair will be created.

passphrase

(required) Base64 passphrase used to secure the private key which will be created on user behalf.

default_region

(optional) The name of the region to establish the Object Storage endpoint. See https://docs.oracle.com/en-us/iaas/api/#/en/identity/20160918/Region/ for additional information.

key_alias

(required) User friendly identifier used to uniquely differentiate between different API keys associated with this Big Data Service cluster. Only ASCII alphanumeric characters with no spaces allowed.

DBMS_CLOUD_OCI_BDS_CREATE_NODE_DETAILS_T Type

The information about the new node.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_create_node_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  node_type varchar2(32767),
  shape varchar2(32767),
  block_volume_size_in_g_bs number,
  subnet_id varchar2(32767),
  shape_config dbms_cloud_oci_bds_shape_config_details_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_create_node_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_create_node_details_t (
    node_type varchar2,
    shape varchar2,
    block_volume_size_in_g_bs number,
    subnet_id varchar2,
    shape_config dbms_cloud_oci_bds_shape_config_details_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

node_type

(required) The Big Data Service cluster node type.

shape

(required) Shape of the node.

block_volume_size_in_g_bs

(required) The size of block volume in GB to be attached to a given node. All the details needed for attaching the block volume are managed by service itself.

subnet_id

(required) The OCID of the subnet in which the node will be created.

shape_config

(optional)

DBMS_CLOUD_OCI_BDS_CREATE_NODE_DETAILS_TBL Type

Nested table type of dbms_cloud_oci_bds_create_node_details_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_create_node_details_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_create_node_details_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_CREATE_BDS_INSTANCE_DETAILS_T Type

The information about the new cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_create_bds_instance_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  compartment_id varchar2(32767),
  display_name varchar2(32767),
  cluster_version varchar2(32767),
  cluster_public_key varchar2(32767),
  cluster_admin_password varchar2(32767),
  is_high_availability number,
  is_secure number,
  network_config dbms_cloud_oci_bds_network_config_t,
  bootstrap_script_url varchar2(32767),
  nodes dbms_cloud_oci_bds_create_node_details_tbl,
  kerberos_realm_name varchar2(32767),
  freeform_tags json_element_t,
  defined_tags json_element_t,
  kms_key_id varchar2(32767),
  cluster_profile varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_create_bds_instance_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_create_bds_instance_details_t (
    compartment_id varchar2,
    display_name varchar2,
    cluster_version varchar2,
    cluster_public_key varchar2,
    cluster_admin_password varchar2,
    is_high_availability number,
    is_secure number,
    network_config dbms_cloud_oci_bds_network_config_t,
    bootstrap_script_url varchar2,
    nodes dbms_cloud_oci_bds_create_node_details_tbl,
    kerberos_realm_name varchar2,
    freeform_tags json_element_t,
    defined_tags json_element_t,
    kms_key_id varchar2,
    cluster_profile varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

compartment_id

(required) The OCID of the compartment.

display_name

(required) Name of the Big Data Service cluster.

cluster_version

(required) Version of the Hadoop distribution.

cluster_public_key

(required) The SSH public key used to authenticate the cluster connection.

cluster_admin_password

(required) Base-64 encoded password for the cluster (and Cloudera Manager) admin user.

is_high_availability

(required) Boolean flag specifying whether or not the cluster is highly available (HA).

is_secure

(required) Boolean flag specifying whether or not the cluster should be set up as secure.

network_config

(optional)

bootstrap_script_url

(optional) Pre-authenticated URL of the script in Object Store that is downloaded and executed.

nodes

(required) The list of nodes in the Big Data Service cluster.

kerberos_realm_name

(optional) The user-defined kerberos realm name.

freeform_tags

(optional) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. For example, `{\"bar-key\": \"value\"}`

defined_tags

(optional) Defined tags for this resource. Each key is predefined and scoped to a namespace. For example, `{\"foo-namespace\": {\"bar-key\": \"value\"}}`

kms_key_id

(optional) The OCID of the Key Management master encryption key.

cluster_profile

(optional) Profile of the Big Data Service cluster.

DBMS_CLOUD_OCI_BDS_CREATE_BDS_METASTORE_CONFIGURATION_DETAILS_T Type

The request body when creating BDS metastore configuration.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_create_bds_metastore_configuration_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  display_name varchar2(32767),
  metastore_id varchar2(32767),
  bds_api_key_id varchar2(32767),
  bds_api_key_passphrase varchar2(32767),
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_create_bds_metastore_configuration_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_create_bds_metastore_configuration_details_t (
    display_name varchar2,
    metastore_id varchar2,
    bds_api_key_id varchar2,
    bds_api_key_passphrase varchar2,
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

display_name

(optional) The display name of the metastore configuration

metastore_id

(required) The OCID of the Data Catalog metastore.

bds_api_key_id

(required) The ID of BDS Api Key used for Data Catalog metastore integration.

bds_api_key_passphrase

(required) Base-64 encoded passphrase of the BDS Api Key.

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

DBMS_CLOUD_OCI_BDS_TIME_AND_HORIZONTAL_SCALING_CONFIG_T Type

Time of day and horizontal scaling configuration.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_time_and_horizontal_scaling_config_t FORCE AUTHID CURRENT_USER IS OBJECT (
  time_recurrence varchar2(32767),
  target_node_count number,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_time_and_horizontal_scaling_config_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_time_and_horizontal_scaling_config_t (
    time_recurrence varchar2,
    target_node_count number
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

time_recurrence

(optional) Day/time recurrence (specified following RFC 5545) at which to trigger autoscaling action. Currently only WEEKLY frequency is supported. Days of the week are specified using BYDAY field. Time of the day is specified using BYHOUR and BYMINUTE fields. Other fields are not supported.

target_node_count

(optional) This value is the desired number of nodes in the cluster.

DBMS_CLOUD_OCI_BDS_TIME_AND_HORIZONTAL_SCALING_CONFIG_TBL Type

Nested table type of dbms_cloud_oci_bds_time_and_horizontal_scaling_config_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_time_and_horizontal_scaling_config_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_time_and_horizontal_scaling_config_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_DAY_BASED_HORIZONTAL_SCALING_SCHEDULE_DETAILS_T Type

Details of day based horizontal scaling schedule.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_day_based_horizontal_scaling_schedule_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_horizontal_scaling_schedule_details_t (
  time_and_horizontal_scaling_config dbms_cloud_oci_bds_time_and_horizontal_scaling_config_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_day_based_horizontal_scaling_schedule_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_day_based_horizontal_scaling_schedule_details_t (
    schedule_type varchar2,
    time_and_horizontal_scaling_config dbms_cloud_oci_bds_time_and_horizontal_scaling_config_tbl
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_day_based_horizontal_scaling_schedule_details_t is a subtype of the dbms_cloud_oci_bds_horizontal_scaling_schedule_details_t type.

Fields

Field Description

time_and_horizontal_scaling_config

(optional) Time of day and horizontal scaling configuration.

DBMS_CLOUD_OCI_BDS_TIME_AND_VERTICAL_SCALING_CONFIG_T Type

Time of day and vertical scaling configuration.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_time_and_vertical_scaling_config_t FORCE AUTHID CURRENT_USER IS OBJECT (
  time_recurrence varchar2(32767),
  target_shape varchar2(32767),
  target_ocpus_per_node number,
  target_memory_per_node number,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_time_and_vertical_scaling_config_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_time_and_vertical_scaling_config_t (
    time_recurrence varchar2,
    target_shape varchar2,
    target_ocpus_per_node number,
    target_memory_per_node number
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

time_recurrence

(optional) Day/time recurrence (specified following RFC 5545) at which to trigger autoscaling action. Currently only WEEKLY frequency is supported. Days of the week are specified using BYDAY field. Time of the day is specified using BYHOUR and BYMINUTE fields. Other fields are not supported.

target_shape

(optional) For nodes with fixed compute shapes, this value is the desired shape of each node. This value is not used for nodes with flexible compute shapes.

target_ocpus_per_node

(optional) For nodes with flexible compute shapes, this value is the desired OCPUs count on each node. This value is not used for nodes with fixed compute shapes.

target_memory_per_node

(optional) For nodes with flexible compute shapes, this value is the desired memory in GBs on each node. This value is not used for nodes with fixed compute shapes.

DBMS_CLOUD_OCI_BDS_TIME_AND_VERTICAL_SCALING_CONFIG_TBL Type

Nested table type of dbms_cloud_oci_bds_time_and_vertical_scaling_config_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_time_and_vertical_scaling_config_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_time_and_vertical_scaling_config_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_DAY_BASED_VERTICAL_SCALING_SCHEDULE_DETAILS_T Type

Details of day based vertical scaling schedule.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_day_based_vertical_scaling_schedule_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_vertical_scaling_schedule_details_t (
  time_and_vertical_scaling_config dbms_cloud_oci_bds_time_and_vertical_scaling_config_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_day_based_vertical_scaling_schedule_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_day_based_vertical_scaling_schedule_details_t (
    schedule_type varchar2,
    time_and_vertical_scaling_config dbms_cloud_oci_bds_time_and_vertical_scaling_config_tbl
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_day_based_vertical_scaling_schedule_details_t is a subtype of the dbms_cloud_oci_bds_vertical_scaling_schedule_details_t type.

Fields

Field Description

time_and_vertical_scaling_config

(optional) Time of day and vertical scaling configuration

DBMS_CLOUD_OCI_BDS_DEFAULT_ERROR_T Type

Error Information.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_default_error_t FORCE AUTHID CURRENT_USER IS OBJECT (
  code varchar2(32767),
  message varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_default_error_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_default_error_t (
    code varchar2,
    message varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

code

(required) A short error code that defines the error, meant for programmatic parsing.

message

(required) A human-readable error string.

DBMS_CLOUD_OCI_BDS_DISABLE_CERTIFICATE_DETAILS_T Type

The request body info about disable certificate service list.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_disable_certificate_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  services dbms_cloud_oci_bds_varchar2_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_disable_certificate_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_disable_certificate_details_t (
    cluster_admin_password varchar2,
    services dbms_cloud_oci_bds_varchar2_tbl
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

services

(required) List of services for which certificate needs to be disabled.

DBMS_CLOUD_OCI_BDS_HOST_CERT_DETAILS_T Type

Details about the host and corresponding certificate.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_host_cert_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  host_name varchar2(32767),
  certificate varchar2(32767),
  private_key varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_host_cert_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_host_cert_details_t (
    host_name varchar2,
    certificate varchar2,
    private_key varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

host_name

(required) Fully qualified domain name (FQDN) of the host

certificate

(required) Certificate value in string format

private_key

(required) Private key of the provided certificate

DBMS_CLOUD_OCI_BDS_HOST_CERT_DETAILS_TBL Type

Nested table type of dbms_cloud_oci_bds_host_cert_details_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_host_cert_details_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_host_cert_details_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_ENABLE_CERTIFICATE_DETAILS_T Type

The request body info about configure certificate service list.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_enable_certificate_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  services dbms_cloud_oci_bds_varchar2_tbl,
  root_certificate varchar2(32767),
  host_cert_details dbms_cloud_oci_bds_host_cert_details_tbl,
  server_key_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_enable_certificate_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_enable_certificate_details_t (
    cluster_admin_password varchar2,
    services dbms_cloud_oci_bds_varchar2_tbl,
    root_certificate varchar2,
    host_cert_details dbms_cloud_oci_bds_host_cert_details_tbl,
    server_key_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

services

(required) List of services for which certificate needs to be enabled.

root_certificate

(optional) Plain text certificate/s in order, separated by new line character. If not provided in request a self-signed root certificate is generated inside the cluster. In case hostCertDetails is provided, root certificate is mandatory.

host_cert_details

(optional) List of leaf certificates to use for services on each host. If custom host certificate is provided the root certificate becomes required.

server_key_password

(optional) Base-64 encoded password for CA certificate's private key. This value can be empty.

DBMS_CLOUD_OCI_BDS_EXECUTE_BOOTSTRAP_SCRIPT_DETAILS_T Type

The information about the bootstrap script to be executed.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_execute_bootstrap_script_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  bootstrap_script_url varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_execute_bootstrap_script_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_execute_bootstrap_script_details_t (
    cluster_admin_password varchar2,
    bootstrap_script_url varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

bootstrap_script_url

(optional) pre-authenticated URL of the bootstrap script in Object Store that can be downloaded and executed.

DBMS_CLOUD_OCI_BDS_INSTALL_OS_PATCH_DETAILS_T Type

Os patch details for installing a os patches to a cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_install_os_patch_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  os_patch_version varchar2(32767),
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_install_os_patch_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_install_os_patch_details_t (
    os_patch_version varchar2,
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

os_patch_version

(required) The target os patch version.

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

DBMS_CLOUD_OCI_BDS_INSTALL_PATCH_DETAILS_T Type

The reqeust body while installing a patch to a cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_install_patch_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  version varchar2(32767),
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_install_patch_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_install_patch_details_t (
    version varchar2,
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

version

(required) The version of the patch to be installed.

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

DBMS_CLOUD_OCI_BDS_METRIC_BASED_HORIZONTAL_SCALING_POLICY_DETAILS_T Type

Details of a metric based horizontal autoscaling policy. In a metric-based autoscaling policy, an autoscaling action is triggered when a performance metric exceeds a threshold.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_metric_based_horizontal_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_auto_scale_policy_details_t (
  scale_out_config dbms_cloud_oci_bds_metric_based_horizontal_scale_out_config_t,
  scale_in_config dbms_cloud_oci_bds_metric_based_horizontal_scale_in_config_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_horizontal_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_horizontal_scaling_policy_details_t (
    policy_type varchar2,
    trigger_type varchar2,
    action_type varchar2,
    scale_out_config dbms_cloud_oci_bds_metric_based_horizontal_scale_out_config_t,
    scale_in_config dbms_cloud_oci_bds_metric_based_horizontal_scale_in_config_t
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_metric_based_horizontal_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_auto_scale_policy_details_t type.

Fields

Field Description

scale_out_config

(optional)

scale_in_config

(optional)

DBMS_CLOUD_OCI_BDS_METRIC_BASED_VERTICAL_SCALING_POLICY_DETAILS_T Type

Details of a metric based vertical autoscaling policy. In a metric-based autoscaling policy, an autoscaling action is triggered when a performance metric exceeds a threshold.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_metric_based_vertical_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_auto_scale_policy_details_t (
  scale_up_config dbms_cloud_oci_bds_metric_based_vertical_scale_up_config_t,
  scale_down_config dbms_cloud_oci_bds_metric_based_vertical_scale_down_config_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_vertical_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_metric_based_vertical_scaling_policy_details_t (
    policy_type varchar2,
    trigger_type varchar2,
    action_type varchar2,
    scale_up_config dbms_cloud_oci_bds_metric_based_vertical_scale_up_config_t,
    scale_down_config dbms_cloud_oci_bds_metric_based_vertical_scale_down_config_t
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_metric_based_vertical_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_auto_scale_policy_details_t type.

Fields

Field Description

scale_up_config

(optional)

scale_down_config

(optional)

DBMS_CLOUD_OCI_BDS_OS_PATCH_PACKAGE_SUMMARY_T Type

Summary of a package contained in a os patch.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_os_patch_package_summary_t FORCE AUTHID CURRENT_USER IS OBJECT (
  package_name varchar2(32767),
  target_version varchar2(32767),
  update_type varchar2(32767),
  related_cv_es dbms_cloud_oci_bds_varchar2_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_os_patch_package_summary_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_os_patch_package_summary_t (
    package_name varchar2,
    target_version varchar2,
    update_type varchar2,
    related_cv_es dbms_cloud_oci_bds_varchar2_tbl
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

package_name

(required) The package's name.

target_version

(optional) The target version of the package.

update_type

(required) The action that current package will be executed on the cluster.

Allowed values are: 'INSTALL', 'REMOVE', 'UPDATE'

related_cv_es

(required) Related CVEs of the package update.

DBMS_CLOUD_OCI_BDS_OS_PATCH_PACKAGE_SUMMARY_TBL Type

Nested table type of dbms_cloud_oci_bds_os_patch_package_summary_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_os_patch_package_summary_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_os_patch_package_summary_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_OS_PATCH_DETAILS_T Type

Details of an os patch.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_os_patch_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  os_patch_version varchar2(32767),
  min_bds_version varchar2(32767),
  min_compatible_odh_version_map json_element_t,
  target_packages dbms_cloud_oci_bds_os_patch_package_summary_tbl,
  release_date timestamp with time zone,
  patch_type varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_os_patch_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_os_patch_details_t (
    os_patch_version varchar2,
    min_bds_version varchar2,
    min_compatible_odh_version_map json_element_t,
    target_packages dbms_cloud_oci_bds_os_patch_package_summary_tbl,
    release_date timestamp with time zone,
    patch_type varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

os_patch_version

(required) Version of the os patch.

min_bds_version

(required) Minimum BDS version required to install current OS patch.

min_compatible_odh_version_map

(required) Map of major ODH version to minimum ODH version required to install current OS patch. e.g. {ODH0.9: 0.9.1}

target_packages

(required) List of summaries of individual target packages.

release_date

(required) Released date of the OS patch.

patch_type

(required) Type of a specific os patch. REGULAR means standard released os patches. CUSTOM means os patches with some customizations. EMERGENT means os patches with some emergency fixes that should be prioritized.

Allowed values are: 'REGULAR', 'CUSTOM', 'EMERGENT'

DBMS_CLOUD_OCI_BDS_OS_PATCH_SUMMARY_T Type

Summary of an available os patch to a cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_os_patch_summary_t FORCE AUTHID CURRENT_USER IS OBJECT (
  os_patch_version varchar2(32767),
  release_date timestamp with time zone,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_os_patch_summary_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_os_patch_summary_t (
    os_patch_version varchar2,
    release_date timestamp with time zone
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

os_patch_version

(required) Patch version of the os patch.

release_date

(required) The time when the OS patch was released.

DBMS_CLOUD_OCI_BDS_PATCH_HISTORY_SUMMARY_T Type

Patch history of this cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_patch_history_summary_t FORCE AUTHID CURRENT_USER IS OBJECT (
  version varchar2(32767),
  lifecycle_state varchar2(32767),
  time_updated timestamp with time zone,
  patch_type varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_patch_history_summary_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_patch_history_summary_t (
    version varchar2,
    lifecycle_state varchar2,
    time_updated timestamp with time zone,
    patch_type varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

version

(required) The version of the patch.

lifecycle_state

(required) The status of this patch.

Allowed values are: 'INSTALLING', 'INSTALLED', 'FAILED'

time_updated

(required) The time when the patch history was last updated.

patch_type

(required) The type of current patch history. DP - Data Plane patch(This history type is internal available only) ODH - Oracle Distribution of Hadoop patch OS - Operating System patch

Allowed values are: 'ODH', 'OS'

DBMS_CLOUD_OCI_BDS_PATCH_SUMMARY_T Type

The patch that is currently available for the cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_patch_summary_t FORCE AUTHID CURRENT_USER IS OBJECT (
  version varchar2(32767),
  time_released timestamp with time zone,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_patch_summary_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_patch_summary_t (
    version varchar2,
    time_released timestamp with time zone
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

version

(required) The version of the patch.

time_released

(required) The time when the patch was released.

DBMS_CLOUD_OCI_BDS_REMOVE_AUTO_SCALING_CONFIGURATION_DETAILS_T Type

The information about the removed autoscale configuration.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_remove_auto_scaling_configuration_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_remove_auto_scaling_configuration_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_remove_auto_scaling_configuration_details_t (
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster (and Cloudera Manager) admin user.

DBMS_CLOUD_OCI_BDS_REMOVE_CLOUD_SQL_DETAILS_T Type

The information about the Cloud SQL installation that was removed.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_remove_cloud_sql_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_remove_cloud_sql_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_remove_cloud_sql_details_t (
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster (and Cloudera Manager) admin user.

DBMS_CLOUD_OCI_BDS_REMOVE_KAFKA_DETAILS_T Type

The information about the Kafka installation to be removed. All configured Kafka nodes are considered for removal.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_remove_kafka_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_remove_kafka_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_remove_kafka_details_t (
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

DBMS_CLOUD_OCI_BDS_REMOVE_NODE_DETAILS_T Type

The information about node to be removed.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_remove_node_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  is_force_remove_enabled number,
  node_id varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_remove_node_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_remove_node_details_t (
    cluster_admin_password varchar2,
    is_force_remove_enabled number,
    node_id varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster (and Cloudera Manager) admin user.

is_force_remove_enabled

(optional) Boolean flag specifying whether or not to force remove node if graceful removal fails.

node_id

(required) OCID of the node to be removed.

DBMS_CLOUD_OCI_BDS_RENEW_CERTIFICATE_DETAILS_T Type

The request body info about renew certificate service list.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_renew_certificate_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  services dbms_cloud_oci_bds_varchar2_tbl,
  root_certificate varchar2(32767),
  host_cert_details dbms_cloud_oci_bds_host_cert_details_tbl,
  server_key_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_renew_certificate_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_renew_certificate_details_t (
    cluster_admin_password varchar2,
    services dbms_cloud_oci_bds_varchar2_tbl,
    root_certificate varchar2,
    host_cert_details dbms_cloud_oci_bds_host_cert_details_tbl,
    server_key_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

services

(optional) List of services for which certificate needs to be renewed. If no services provided renew will happen only for default services - AMBARI,RANGER,HUE,LIVY.

root_certificate

(optional) Plain text certificate/s in order, separated by new line character. If not provided in request a self-signed root certificate is generated inside the cluster. In case hostCertDetails is provided, root certificate is mandatory.

host_cert_details

(optional) List of leaf certificates to use for services on each host. If custom host certificate is provided the root certificate becomes required.

server_key_password

(optional) Base-64 encoded password for CA certificate's private key. This value can be empty.

DBMS_CLOUD_OCI_BDS_RESTART_NODE_DETAILS_T Type

The information about restarted node.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_restart_node_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  node_id varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_restart_node_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_restart_node_details_t (
    node_id varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

node_id

(required) OCID of the node to be restarted.

DBMS_CLOUD_OCI_BDS_SCHEDULE_BASED_HORIZONTAL_SCALING_POLICY_DETAILS_T Type

Details of a schedule based horizontal autoscaling policy. In a schedule-based autoscaling policy, an autoscaling action is triggered at the scheduled execution time.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_schedule_based_horizontal_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_auto_scale_policy_details_t (
  timezone varchar2(32767),
  schedule_details dbms_cloud_oci_bds_horizontal_scaling_schedule_details_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_schedule_based_horizontal_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_schedule_based_horizontal_scaling_policy_details_t (
    policy_type varchar2,
    trigger_type varchar2,
    action_type varchar2,
    timezone varchar2,
    schedule_details dbms_cloud_oci_bds_horizontal_scaling_schedule_details_tbl
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_schedule_based_horizontal_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_auto_scale_policy_details_t type.

Fields

Field Description

timezone

(optional) The time zone of the execution schedule, in IANA time zone database name format

schedule_details

(optional) Details of a horizontal scaling schedule.

DBMS_CLOUD_OCI_BDS_SCHEDULE_BASED_VERTICAL_SCALING_POLICY_DETAILS_T Type

Details of a schedule based vertical autoscaling policy. In a schedule-based autoscaling policy, an autoscaling action is triggered at the scheduled execution time.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_schedule_based_vertical_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_auto_scale_policy_details_t (
  timezone varchar2(32767),
  schedule_details dbms_cloud_oci_bds_vertical_scaling_schedule_details_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_schedule_based_vertical_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_schedule_based_vertical_scaling_policy_details_t (
    policy_type varchar2,
    trigger_type varchar2,
    action_type varchar2,
    timezone varchar2,
    schedule_details dbms_cloud_oci_bds_vertical_scaling_schedule_details_tbl
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_schedule_based_vertical_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_auto_scale_policy_details_t type.

Fields

Field Description

timezone

(optional) The time zone of the execution schedule, in IANA time zone database name format

schedule_details

(optional) Details of a vertical scaling schedule.

DBMS_CLOUD_OCI_BDS_START_BDS_INSTANCE_DETAILS_T Type

The request body for starting a BDS cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_start_bds_instance_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_start_bds_instance_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_start_bds_instance_details_t (
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

DBMS_CLOUD_OCI_BDS_STOP_BDS_INSTANCE_DETAILS_T Type

The request body for stopping a BDS cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_stop_bds_instance_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  is_force_stop_jobs number,
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_stop_bds_instance_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_stop_bds_instance_details_t (
    is_force_stop_jobs number,
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

is_force_stop_jobs

(optional) Boolean indicating whether to force stop jobs while stopping cluster. Defaults to false.

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

DBMS_CLOUD_OCI_BDS_TEST_BDS_METASTORE_CONFIGURATION_DETAILS_T Type

The reqeust body when testing a BDS metastore configuration

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_test_bds_metastore_configuration_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_test_bds_metastore_configuration_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_test_bds_metastore_configuration_details_t (
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

cluster_admin_password

(required) Base-64 encoded password for the cluster admin user.

DBMS_CLOUD_OCI_BDS_TEST_BDS_OBJECT_STORAGE_CONNECTION_DETAILS_T Type

Test access to specified Object Storage bucket using the API key.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_test_bds_object_storage_connection_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  object_storage_uri varchar2(32767),
  passphrase varchar2(32767),
  object_storage_region varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_test_bds_object_storage_connection_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_test_bds_object_storage_connection_details_t (
    object_storage_uri varchar2,
    passphrase varchar2,
    object_storage_region varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

object_storage_uri

(required) An Oracle Cloud Infrastructure URI to which this connection must be attempted. See https://docs.cloud.oracle.com/iaas/Content/API/SDKDocs/hdfsconnector.htm#uriformat.

passphrase

(required) Base64 passphrase used to secure the private key which will be created on user behalf.

object_storage_region

(optional) The name of the region to establish the Object Storage endpoint. Example us-phoenix-1 .

DBMS_CLOUD_OCI_BDS_UPDATE_AUTO_SCALE_POLICY_DETAILS_T Type

Update details of an autoscaling policy.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_update_auto_scale_policy_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  policy_type varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_auto_scale_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_auto_scale_policy_details_t (
    policy_type varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE NOT FINAL;

Fields

Field Description

policy_type

(required) Type of autoscaling policy.

DBMS_CLOUD_OCI_BDS_UPDATE_AUTO_SCALING_CONFIGURATION_DETAILS_T Type

The information about the autoscale configuration.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_update_auto_scaling_configuration_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  display_name varchar2(32767),
  is_enabled number,
  cluster_admin_password varchar2(32767),
  policy dbms_cloud_oci_bds_auto_scale_policy_t,
  policy_details dbms_cloud_oci_bds_update_auto_scale_policy_details_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_auto_scaling_configuration_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_auto_scaling_configuration_details_t (
    display_name varchar2,
    is_enabled number,
    cluster_admin_password varchar2,
    policy dbms_cloud_oci_bds_auto_scale_policy_t,
    policy_details dbms_cloud_oci_bds_update_auto_scale_policy_details_t
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

display_name

(optional) A user-friendly name. The name does not have to be unique, and it may be changed. Avoid entering confidential information.

is_enabled

(optional) Whether the autoscale configuration is enabled.

cluster_admin_password

(optional) Base-64 encoded password for the cluster (and Cloudera Manager) admin user.

policy

(optional)

policy_details

(optional)

DBMS_CLOUD_OCI_BDS_UPDATE_BDS_INSTANCE_DETAILS_T Type

The information about to-be-updated Big Data Service cluster.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_update_bds_instance_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  display_name varchar2(32767),
  bootstrap_script_url varchar2(32767),
  freeform_tags json_element_t,
  defined_tags json_element_t,
  kms_key_id varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_bds_instance_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_bds_instance_details_t (
    display_name varchar2,
    bootstrap_script_url varchar2,
    freeform_tags json_element_t,
    defined_tags json_element_t,
    kms_key_id varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

display_name

(optional) Name of the cluster.

bootstrap_script_url

(optional) Pre-authenticated URL of the bootstrap script in Object Store that can be downloaded and executed..

freeform_tags

(optional) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. For example, `{\"bar-key\": \"value\"}`

defined_tags

(optional) Defined tags for this resource. Each key is predefined and scoped to a namespace. For example, `{\"foo-namespace\": {\"bar-key\": \"value\"}}`

kms_key_id

(optional) The OCID of the Key Management master encryption key.

DBMS_CLOUD_OCI_BDS_UPDATE_BDS_METASTORE_CONFIGURATION_DETAILS_T Type

The request body when updating BDS metastore configuration.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_update_bds_metastore_configuration_details_t FORCE AUTHID CURRENT_USER IS OBJECT (
  display_name varchar2(32767),
  bds_api_key_id varchar2(32767),
  bds_api_key_passphrase varchar2(32767),
  cluster_admin_password varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_bds_metastore_configuration_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_bds_metastore_configuration_details_t (
    display_name varchar2,
    bds_api_key_id varchar2,
    bds_api_key_passphrase varchar2,
    cluster_admin_password varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

display_name

(optional) The display name of the metastore configuration.

bds_api_key_id

(optional) The ID of BDS Api Key used for Data Catalog metastore integration. Set only if metastore's type is EXTERNAL.

bds_api_key_passphrase

(optional) Base-64 encoded passphrase of the BDS Api Key.

cluster_admin_password

(optional) Base-64 encoded password for the cluster admin user.

DBMS_CLOUD_OCI_BDS_UPDATE_METRIC_BASED_HORIZONTAL_SCALING_POLICY_DETAILS_T Type

Update details of a metric based horizontal autoscaling policy. In a metric-based autoscaling policy, an autoscaling action is triggered when a performance metric exceeds a threshold.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_update_metric_based_horizontal_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_update_auto_scale_policy_details_t (
  scale_out_config dbms_cloud_oci_bds_metric_based_horizontal_scale_out_config_t,
  scale_in_config dbms_cloud_oci_bds_metric_based_horizontal_scale_in_config_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_metric_based_horizontal_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_metric_based_horizontal_scaling_policy_details_t (
    policy_type varchar2,
    scale_out_config dbms_cloud_oci_bds_metric_based_horizontal_scale_out_config_t,
    scale_in_config dbms_cloud_oci_bds_metric_based_horizontal_scale_in_config_t
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_update_metric_based_horizontal_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_update_auto_scale_policy_details_t type.

Fields

Field Description

scale_out_config

(optional)

scale_in_config

(optional)

DBMS_CLOUD_OCI_BDS_UPDATE_METRIC_BASED_VERTICAL_SCALING_POLICY_DETAILS_T Type

Update details of a metric based vertical autoscaling policy. In a metric-based autoscaling policy, an autoscaling action is triggered when a performance metric exceeds a threshold.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_update_metric_based_vertical_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_update_auto_scale_policy_details_t (
  scale_up_config dbms_cloud_oci_bds_metric_based_vertical_scale_up_config_t,
  scale_down_config dbms_cloud_oci_bds_metric_based_vertical_scale_down_config_t,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_metric_based_vertical_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_metric_based_vertical_scaling_policy_details_t (
    policy_type varchar2,
    scale_up_config dbms_cloud_oci_bds_metric_based_vertical_scale_up_config_t,
    scale_down_config dbms_cloud_oci_bds_metric_based_vertical_scale_down_config_t
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_update_metric_based_vertical_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_update_auto_scale_policy_details_t type.

Fields

Field Description

scale_up_config

(optional)

scale_down_config

(optional)

DBMS_CLOUD_OCI_BDS_UPDATE_SCHEDULE_BASED_HORIZONTAL_SCALING_POLICY_DETAILS_T Type

Update details of a schedule based horizontal autoscaling policy. In a schedule-based autoscaling policy, an autoscaling action is triggered at the scheduled execution time.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_update_schedule_based_horizontal_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_update_auto_scale_policy_details_t (
  timezone varchar2(32767),
  schedule_details dbms_cloud_oci_bds_horizontal_scaling_schedule_details_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_schedule_based_horizontal_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_schedule_based_horizontal_scaling_policy_details_t (
    policy_type varchar2,
    timezone varchar2,
    schedule_details dbms_cloud_oci_bds_horizontal_scaling_schedule_details_tbl
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_update_schedule_based_horizontal_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_update_auto_scale_policy_details_t type.

Fields

Field Description

timezone

(optional) The time zone of the execution schedule, in IANA time zone database name format

schedule_details

(optional) Details of a horizontal scaling schedule.

DBMS_CLOUD_OCI_BDS_UPDATE_SCHEDULE_BASED_VERTICAL_SCALING_POLICY_DETAILS_T Type

Update details of a schedule based vertical autoscaling policy. In a schedule-based autoscaling policy, an autoscaling action is triggered at the scheduled execution time.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_update_schedule_based_vertical_scaling_policy_details_t FORCE AUTHID CURRENT_USER UNDER dbms_cloud_oci_bds_update_auto_scale_policy_details_t (
  timezone varchar2(32767),
  schedule_details dbms_cloud_oci_bds_vertical_scaling_schedule_details_tbl,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_schedule_based_vertical_scaling_policy_details_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_update_schedule_based_vertical_scaling_policy_details_t (
    policy_type varchar2,
    timezone varchar2,
    schedule_details dbms_cloud_oci_bds_vertical_scaling_schedule_details_tbl
  ) RETURN SELF AS RESULT
);

dbms_cloud_oci_bds_update_schedule_based_vertical_scaling_policy_details_t is a subtype of the dbms_cloud_oci_bds_update_auto_scale_policy_details_t type.

Fields

Field Description

timezone

(optional) The time zone of the execution schedule, in IANA time zone database name format

schedule_details

(optional) Details of a vertical scaling schedule.

DBMS_CLOUD_OCI_BDS_WORK_REQUEST_RESOURCE_T Type

A resource created or operated on by a work request.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_work_request_resource_t FORCE AUTHID CURRENT_USER IS OBJECT (
  entity_type varchar2(32767),
  action_type varchar2(32767),
  identifier varchar2(32767),
  entity_uri varchar2(32767),
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_work_request_resource_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_work_request_resource_t (
    entity_type varchar2,
    action_type varchar2,
    identifier varchar2,
    entity_uri varchar2
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

entity_type

(required) The resource type the work request affects.

action_type

(required) The way in which this resource is affected by the work tracked in the work request. A resource being created, updated, or deleted remains in the IN_PROGRESS state until work is complete for that resource, at which point it will transition to CREATED, UPDATED, or DELETED, respectively.

Allowed values are: 'CREATED', 'UPDATED', 'DELETED', 'IN_PROGRESS', 'FAILED'

identifier

(required) The OCID of the resource the work request affects.

entity_uri

(optional) The URI path that the user can do a GET on to access the resource metadata.

DBMS_CLOUD_OCI_BDS_WORK_REQUEST_RESOURCE_TBL Type

Nested table type of dbms_cloud_oci_bds_work_request_resource_t.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_work_request_resource_tbl FORCE IS TABLE OF (dbms_cloud_oci_bds_work_request_resource_t) NOT PERSISTABLE;

DBMS_CLOUD_OCI_BDS_WORK_REQUEST_T Type

Description of the work request status.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_work_request_t FORCE AUTHID CURRENT_USER IS OBJECT (
  id varchar2(32767),
  compartment_id varchar2(32767),
  operation_type varchar2(32767),
  status varchar2(32767),
  resources dbms_cloud_oci_bds_work_request_resource_tbl,
  percent_complete number,
  time_accepted timestamp with time zone,
  time_started timestamp with time zone,
  time_finished timestamp with time zone,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_work_request_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_work_request_t (
    id varchar2,
    compartment_id varchar2,
    operation_type varchar2,
    status varchar2,
    resources dbms_cloud_oci_bds_work_request_resource_tbl,
    percent_complete number,
    time_accepted timestamp with time zone,
    time_started timestamp with time zone,
    time_finished timestamp with time zone
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

id

(required) The ID of the work request.

compartment_id

(required) The OCID of the compartment that contains the work request. Work requests should be scoped to the same compartment as the resource the work request affects. If the work request affects multiple resources, and those resources are not in the same compartment, it is up to the service team to pick the primary resource whose compartment should be used.

operation_type

(required) The type of this work request.

Allowed values are: 'CREATE_BDS', 'UPDATE_BDS', 'DELETE_BDS', 'ADD_BLOCK_STORAGE', 'ADD_MASTER_NODES', 'ADD_UTILITY_NODES', 'ADD_WORKER_NODES', 'ADD_CLOUD_SQL', 'REMOVE_CLOUD_SQL', 'CHANGE_COMPARTMENT_FOR_BDS', 'CHANGE_SHAPE', 'UPDATE_INFRA', 'RESTART_NODE', 'REMOVE_NODE', 'CREATE_AUTOSCALE_CONFIG', 'UPDATE_AUTOSCALE_CONFIG', 'DELETE_AUTOSCALE_CONFIG', 'AUTOSCALE_CONFIG', 'AUTOSCALE_RUN', 'CREATE_API_KEY', 'DELETE_API_KEY', 'TEST_OBJECT_STORE_CONNECTION', 'CREATE_METASTORE_CONFIG', 'DELETE_METASTORE_CONFIG', 'UPDATE_METASTORE_CONFIG', 'ACTIVATE_METASTORE_CONFIG', 'TEST_METASTORE_CONFIG', 'PATCH_BDS', 'PATCH_ODH', 'PATCH_OS', 'STOP_BDS', 'START_BDS', 'ADD_KAFKA', 'REMOVE_KAFKA', 'EXECUTE_BOOTSTRAP_SCRIPT', 'ODH_SERVICE_CERTIFICATE_UPDATE'

status

(required) The status of this work request.

Allowed values are: 'ACCEPTED', 'IN_PROGRESS', 'FAILED', 'SUCCEEDED', 'CANCELING', 'CANCELED'

resources

(required) The resources affected by this work request.

percent_complete

(required) Percentage of this work request completed.

time_accepted

(required) The date and time the request was created, shown as an RFC 3339 formatted datetime string.

time_started

(optional) The time the request was started, shown as an RFC 3339 formatted datetime string.

time_finished

(optional) The time the object was finished, shown as an RFC 3339 formatted datetime string.

DBMS_CLOUD_OCI_BDS_WORK_REQUEST_ERROR_T Type

An error encountered while executing a work request.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_work_request_error_t FORCE AUTHID CURRENT_USER IS OBJECT (
  code varchar2(32767),
  message varchar2(32767),
  l_timestamp timestamp with time zone,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_work_request_error_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_work_request_error_t (
    code varchar2,
    message varchar2,
    l_timestamp timestamp with time zone
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

code

(required) A machine-usable code for the error that occured. Error codes are listed on (https://docs.oracle.com/en-us/iaas/Content/API/References/apierrors.htm).

message

(required) A human readable description of the issue encountered.

l_timestamp

(required) The time the error occured, shown as an RFC 3339 formatted datetime string.

DBMS_CLOUD_OCI_BDS_WORK_REQUEST_LOG_ENTRY_T Type

A log message from the execution of a work request.

Syntax

CREATE OR REPLACE NONEDITIONABLE TYPE dbms_cloud_oci_bds_work_request_log_entry_t FORCE AUTHID CURRENT_USER IS OBJECT (
  message varchar2(32767),
  l_timestamp timestamp with time zone,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_work_request_log_entry_t
    RETURN SELF AS RESULT,
  CONSTRUCTOR FUNCTION dbms_cloud_oci_bds_work_request_log_entry_t (
    message varchar2,
    l_timestamp timestamp with time zone
  ) RETURN SELF AS RESULT
) NOT PERSISTABLE;

Fields

Field Description

message

(required) Human-readable log message.

l_timestamp

(required) The time the log message was written, shown as an RFC 3339 formatted datetime string.

Was this article helpful?