update-database¶

Description¶

Update an operational database in an environment

Synopsis¶

  update-database
--environment-name <value>
--database-name <value>
[--auto-scaling-parameters <value>]
[--num-desired-strong-meta-servers <value>]
[--remove-strong-meta-servers | --no-remove-strong-meta-servers]
[--catalog <value>]
[--vertical-scale <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.

maxHdfsUsagePercentage -> (integer)

The maximum percentage of HDFS utilization for the database before we trigger the scaling.

maxRegionsPerRegionServer -> (integer)

The maximum number of regions per region server.

maxCpuUtilization -> (integer)

The maximum percentage threshold for the CPU utilization of the worker nodes. The CPU utilization is obtained from the Cloudera Manager metric ‘cpu_percent’ across worker nodes. Set 100 or more to disable the CPU metrics.

maxComputeNodesForDatabase -> (integer)

The maximum number of compute nodes, as per these metrics, that can be scaled up to.

minComputeNodesForDatabase -> (integer)

The minimum number of compute nodes, as per these metrics, that can be scaled down to.

Shorthand Syntax:

targetedValueForMetric=integer,maxWorkersForDatabase=integer,maxWorkersPerBatch=integer,minWorkersForDatabase=integer,evaluationPeriod=integer,minimumBlockCacheGb=integer,maxHdfsUsagePercentage=integer,maxRegionsPerRegionServer=integer,maxCpuUtilization=integer,maxComputeNodesForDatabase=integer,minComputeNodesForDatabase=integer

JSON Syntax:

{
  "targetedValueForMetric": integer,
  "maxWorkersForDatabase": integer,
  "maxWorkersPerBatch": integer,
  "minWorkersForDatabase": integer,
  "evaluationPeriod": integer,
  "minimumBlockCacheGb": integer,
  "maxHdfsUsagePercentage": integer,
  "maxRegionsPerRegionServer": integer,
  "maxCpuUtilization": integer,
  "maxComputeNodesForDatabase": integer,
  "minComputeNodesForDatabase": integer
}

--num-desired-strong-meta-servers (integer)

The desired number of strong meta servers for this database. A positive, non-zero number is required. Use remove-strong-meta-servers to remove strong meta servers entirely. Requires the COD_STRONG_META_SERVERS entitlement.

--remove-strong-meta-servers | --no-remove-strong-meta-servers (boolean)

Removes any strong meta servers provisioned for this database. Requires the COD_STRONG_META_SERVERS entitlement.

--catalog (string)

Catalog name for the image.

--vertical-scale (string)

Group type for the database nodes. GATEWAY - GATEWAY value of the Group variable. MASTER - MASTER value of the Group variable.

Possible values:

• GATEWAY

• MASTER

--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¶

Form Factors¶

public