Skip to content

Update Schema

glue_update_schema R Documentation

Updates the description, compatibility setting, or version checkpoint for a schema set

Description

Updates the description, compatibility setting, or version checkpoint for a schema set.

For updating the compatibility setting, the call will not validate compatibility for the entire set of schema versions with the new compatibility setting. If the value for Compatibility is provided, the VersionNumber (a checkpoint) is also required. The API will validate the checkpoint version number for consistency.

If the value for the VersionNumber (checkpoint) is provided, Compatibility is optional and this can be used to set/reset a checkpoint for the schema.

This update will happen only if the schema is in the AVAILABLE state.

Usage

glue_update_schema(SchemaId, SchemaVersionNumber, Compatibility,
  Description)

Arguments

SchemaId

[required] This is a wrapper structure to contain schema identity fields. The structure contains:

  • SchemaId$SchemaArn: The Amazon Resource Name (ARN) of the schema. One of SchemaArn or SchemaName has to be provided.

  • SchemaId$SchemaName: The name of the schema. One of SchemaArn or SchemaName has to be provided.

SchemaVersionNumber

Version number required for check pointing. One of VersionNumber or Compatibility has to be provided.

Compatibility

The new compatibility setting for the schema.

Description

The new description for the schema.

Value

A list with the following syntax: 

list(
  SchemaArn = "string",
  SchemaName = "string",
  RegistryName = "string"
)

Request syntax

svc$update_schema(
  SchemaId = list(
    SchemaArn = "string",
    SchemaName = "string",
    RegistryName = "string"
  ),
  SchemaVersionNumber = list(
    LatestVersion = TRUE|FALSE,
    VersionNumber = 123
  ),
  Compatibility = "NONE"|"DISABLED"|"BACKWARD"|"BACKWARD_ALL"|"FORWARD"|"FORWARD_ALL"|"FULL"|"FULL_ALL",
  Description = "string"
)