create-database¶

Description¶

Create a operational database in a environment

Synopsis¶

  create-database
--environment-name <value>
--database-name <value>
[--auto-scaling-parameters <value>]
[--subnet-id <value>]
[--custom-user-tags <value>]
[--disable-multi-az | --no-disable-multi-az]
[--attached-storage-for-workers <value>]
[--disable-kerberos | --no-disable-kerberos]
[--num-edge-nodes <value>]
[--image <value>]
[--disable-jwt-auth | --no-disable-jwt-auth]
[--enable-region-canary | --no-enable-region-canary]
[--scale-type <value>]
[--storage-type <value>]
[--recipes <value>]
[--enable-grafana | --no-enable-grafana]
[--root-volume-size <value>]
[--volume-encryptions <value>]
[--gateway-nodes-count <value>]
[--restworker-nodes-count <value>]
[--custom-instance-types <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton]

Options¶

--environment-name (string)

environment name

--database-name (string)

database name

--auto-scaling-parameters (object)

A Parameters to configure AutoScaling

targetedValueForMetric -> (integer)

The target value of the metric a user expect to maintain for the cluster

maxWorkersForDatabase -> (integer)

Maximum number of worker nodes as per this metrics can be scaled up to.

maxWorkersPerBatch -> (integer)

Maximum number of worker nodes as per this metrics can be scaled up to in one batch.

minWorkersForDatabase -> (integer)

Minimum number of worker nodes as per this metrics can be scaled down to.

evaluationPeriod -> (integer)

Period of metrics(in seconds) needs to be considered.

minimumBlockCacheGb -> (integer)

The amount of block cache, in Gigabytes, which the database should have.

Shorthand Syntax:

targetedValueForMetric=integer,maxWorkersForDatabase=integer,maxWorkersPerBatch=integer,minWorkersForDatabase=integer,evaluationPeriod=integer,minimumBlockCacheGb=integer

JSON Syntax:

{
  "targetedValueForMetric": integer,
  "maxWorkersForDatabase": integer,
  "maxWorkersPerBatch": integer,
  "minWorkersForDatabase": integer,
  "evaluationPeriod": integer,
  "minimumBlockCacheGb": integer
}

--subnet-id (string)

Override subnet where the database will be deployed. Disables Multi-AZ if set [only for AWS].

--custom-user-tags (array)

Optional tags to apply to launched infrastructure resources

Shorthand Syntax:

key=string,value=string ... (separate items with spaces)

JSON Syntax:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--disable-multi-az | --no-disable-multi-az (boolean)

Disable deployment into multiple availability-zones (the database will be deployed into one subnet).

--attached-storage-for-workers (object)

Attached storage for the worker nodes for AWS, Azure, and GCP cloud providers.

volumeCount -> (integer)

The number of Volumes. Default is 4. Valid Range: Minimum value of 1, maximum value 8.

volumeSize -> (integer)

The target size of the volume, in GiB. Default is 2048.

volumeType -> (string)

Volume Type. HDD - Hard disk drives (HDD) volume type. Default is HDD. SSD - Solid disk drives (SSD) volume type. LOCAL_SSD - Local SSD volume type.

Shorthand Syntax:

volumeCount=integer,volumeSize=integer,volumeType=string

JSON Syntax:

{
  "volumeCount": integer,
  "volumeSize": integer,
  "volumeType": "HDD"|"SSD"|"LOCAL_SSD"
}

--disable-kerberos | --no-disable-kerberos (boolean)

Disable Kerberos authentication.

--num-edge-nodes (integer)

Number of edge nodes to be created for the database. A positive, non-zero number is required. The default value is 0.

--image (object)

Details of an Image.

id -> (string)

Image ID for the database.

catalog -> (string)

Catalog name for the image.

Shorthand Syntax:

id=string,catalog=string

JSON Syntax:

{
  "id": "string",
  "catalog": "string"
}

--disable-jwt-auth | --no-disable-jwt-auth (boolean)

Disable OAuth Bearer (JWT) authentication scheme.

--enable-region-canary | --no-enable-region-canary (boolean)

To enable the region canary for the database.

--scale-type (string)

Scale type. MICRO - Create a 2-node cluster (1 gateway and 1 worker) with high availability disabled. LIGHT - Create a multi-node cluster with a light master and gateway instance type. HEAVY - Create a multi-node cluster with heavy master and gateway instance type.

Possible values:

• MICRO

• LIGHT

• HEAVY

--storage-type (string)

Storage type for clusters. CLOUD_WITH_EPHEMERAL - Cloud with ephemeral storage. CLOUD - Cloud storage without ephemeral storage. HDFS - HDFS storage. CLOUD_WITH_EPHEMERAL_DATATIERING - Cloud with Ephemeral Storage and Datatiering.

Possible values:

• CLOUD_WITH_EPHEMERAL

• CLOUD

• HDFS

--recipes (array)

Custom recipes for the database.

Shorthand Syntax:

names=string,string,instanceGroup=string ... (separate items with spaces)

JSON Syntax:

[
  {
    "names": ["string", ...],
    "instanceGroup": "WORKER"|"LEADER"|"MASTER"|"GATEWAY"|"STRONGMETA"|"EDGE"
  }
  ...
]

--enable-grafana | --no-enable-grafana (boolean)

To enable grafana server for the database.

--root-volume-size (integer)

Root volume size in GiB.

--volume-encryptions (array)

Specifies encryption key to encrypt volume for instance group. It is currently supported for AWS cloud provider only.

Shorthand Syntax:

encryptionKey=string,instanceGroup=string ... (separate items with spaces)

JSON Syntax:

[
  {
    "encryptionKey": "string",
    "instanceGroup": "WORKER"|"LEADER"|"MASTER"|"GATEWAY"|"STRONGMETA"|"EDGE"
  }
  ...
]

--gateway-nodes-count (integer)

Number of gateway nodes to be created for the database. When multiple gateway nodes are present Knox works in HA mode. A positive, non-zero number is required. The default value is 1. Requires the COD_RESTWORKERS entitlement.

--restworker-nodes-count (integer)

Number of REST Worker nodes to be created for the database. A positive, non-zero number is required. The default value is 0. Requires the COD_RESTWORKERS entitlement.

--custom-instance-types (object)

Custom VM Instance Types.

masterType -> (string)

Master VM Instance Type.

workerType -> (string)

Worker VM Instance Type.

gatewayType -> (string)

Gateway VM Instance Type.

leaderType -> (string)

Leader VM Instance Type.

edgeType -> (string)

Edge VM Instance Type.

computeType -> (string)

Compute VM Instance Type.

Shorthand Syntax:

masterType=string,workerType=string,gatewayType=string,leaderType=string,edgeType=string,computeType=string

JSON Syntax:

{
  "masterType": "string",
  "workerType": "string",
  "gatewayType": "string",
  "leaderType": "string",
  "edgeType": "string",
  "computeType": "string"
}

--cli-input-json (string)

Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (boolean)

Prints a sample input JSON to standard output. Note the specified operation is not run if this argument is specified. The sample input can be used as an argument for --cli-input-json.

Output¶

databaseDetails -> (object)

Details of the databases.

databaseName -> (string)

The name of the database.

environmentCrn -> (string)

environment crn

crn -> (string)

database crn

creationDate -> (datetime)

The creation time of the database

status -> (string)

status of the database

creatorCrn -> (string)

Crn of the creator

dbVersion -> (string)

Database version

hueEndpoint -> (string)

Hue endpoint

environmentName -> (string)

Environment name

storageLocation -> (string)

HBase cloud storage location

internalName -> (string)

Internal cluster name for this database

gatewayNodesCount -> (integer)

Number of gateway nodes for the database.

restworkerNodesCount -> (integer)

Number of REST Worker nodes for the database.

Form Factors¶

public