

# Tipos de datos comunes
<a name="aws-glue-api-common"></a>

Los tipos de datos comunes describen diversos tipos de datos comunes en AWS Glue.

## Estructura de etiquetas
<a name="aws-glue-api-common-Tag"></a>

El objeto `Tag` representa una etiqueta que se puede asignar a un recurso de AWS. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario.

Para obtener más información acerca de las etiquetas y controlar el acceso a los recursos en AWS Glue, consulte [Etiquetas de AWS en AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) y [Especificación de ARN de recursos de AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html) en la Guía para desarrolladores.

**Fields**
+ `key`: cadena UTF-8, con 1 byte de largo como mínimo y 128 bytes de largo como máximo.

  La clave de la etiqueta. La clave es necesaria para crear una etiqueta en un objeto. La clave distingue entre mayúsculas y minúsculas y no debe contener el prefijo aws.
+ `value`: cadena UTF-8 de 256 bytes de largo como máximo.

  El valor de la etiqueta. El valor es opcional para crear una etiqueta en un objeto. El valor distingue entre mayúsculas y minúsculas y no debe contener el prefijo aws.

## Estructura DecimalNumber
<a name="aws-glue-api-common-DecimalNumber"></a>

Contiene un valor numérico en formato decimal.

**Fields**
+ `UnscaledValue` – *Obligatorio:* Blob.

  El valor numérico sin escala.
+ `Scale` – *Obligatorio:* número (entero).

  Escala que determina la ubicación de punto decimal en el valor sin escala.

## Estructura ErrorDetail
<a name="aws-glue-api-common-ErrorDetail"></a>

Contiene detalles sobre un error.

**Fields**
+ `ErrorCode` – cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el [Single-line string pattern](#aws-glue-api-regex-oneLine).

  El código asociado a este error.
+ `ErrorMessage` – cadena de descripción de un máximo de 2048 bytes de largo, que coincide con el [URI address multi-line string pattern](#aws-glue-api-regex-uri).

  Mensaje que describe el error.

## Estructura PropertyPredicate
<a name="aws-glue-api-common-PropertyPredicate"></a>

Define el predicado de una propiedad.

**Fields**
+ `Key`: cadena de valor con una extensión de 1 byte como mínimo o 1024 bytes como máximo.

  La clave de la propiedad.
+ `Value`: cadena de valor con una extensión de 1 byte como mínimo o 1024 bytes como máximo.

  El valor de la propiedad.
+ `Comparator` – Cadena UTF-8 (valores válidos: `EQUALS` \| `GREATER_THAN` \| `LESS_THAN` \| `GREATER_THAN_EQUALS` \| `LESS_THAN_EQUALS`).

  El comparador utilizado para comparar esta propiedad con otras

## Estructura ResourceUri
<a name="aws-glue-api-common-ResourceUri"></a>

Las URI para los recursos de función.

**Fields**
+ `ResourceType` – Cadena UTF-8 (valores válidos: `JAR` \| `FILE` \| `ARCHIVE`).

  El tipo de recurso.
+ `Uri` – identificador uniforme de recursos (uri), con 1 byte de largo como mínimo y 1024 bytes de largo como máximo, que coincide con el [URI address multi-line string pattern](#aws-glue-api-regex-uri).

  El URI para obtener acceso al recurso.

## Estructura ColumnStatistics
<a name="aws-glue-api-common-ColumnStatistics"></a>

Representa las estadísticas de nivel de columna generadas para una tabla o partición.

**Fields**
+ `ColumnName`: *obligatorio:* cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el [Single-line string pattern](#aws-glue-api-regex-oneLine).

  Nombre de la columna a la que pertenecen las estadísticas.
+ `ColumnType` – *Obligatorio:* nombre de tipo, de 20 000 bytes de largo como máximo, que coincide con [Single-line string pattern](#aws-glue-api-regex-oneLine).

  El tipo de datos de la columna.
+ `AnalyzedTime` – *Obligatorio:* marca temporal.

  Marca temporal del momento en que se generaron las estadísticas de columna.
+ `StatisticsData`: *obligatorio:* objeto [ColumnStatisticsData](#aws-glue-api-common-ColumnStatisticsData).

  Objeto `ColumnStatisticData` que contiene los valores de datos estadísticos.

## Estructura ColumnStatisticsError
<a name="aws-glue-api-common-ColumnStatisticsError"></a>

Encapsula un objeto `ColumnStatistics` que presentó error y el motivo del error.

**Fields**
+ `ColumnStatistics`: un objeto [ColumnStatistics](#aws-glue-api-common-ColumnStatistics).

  Las `ColumnStatistics` de la columna.
+ `Error`: un objeto [ErrorDetail](#aws-glue-api-common-ErrorDetail).

  Un mensaje de error con el motivo del error de una operación.

## Estructura ColumnError
<a name="aws-glue-api-common-ColumnError"></a>

Encapsula un nombre columna que presentó error y el motivo del error.

**Fields**
+ `ColumnName` – cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el [Single-line string pattern](#aws-glue-api-regex-oneLine).

  El nombre de la columna que presentó error.
+ `Error`: un objeto [ErrorDetail](#aws-glue-api-common-ErrorDetail).

  Un mensaje de error con el motivo del error de una operación.

## Estructura ColumnStatisticsData
<a name="aws-glue-api-common-ColumnStatisticsData"></a>

Contiene los tipos individuales de datos estadísticos de columna. Solo se debe establecer un objeto de datos e indicar mediante el atributo `Type`.

**Fields**
+ `Type` – *Obligatorio:* cadena UTF-8 (valores válidos: `BOOLEAN` \| `DATE` \| `DECIMAL` \| `DOUBLE` \| `LONG` \| `STRING` \| `BINARY`).

  Los datos estadísticos del tipo de columna.
+ `BooleanColumnStatisticsData`: un objeto [BooleanColumnStatisticsData](#aws-glue-api-common-BooleanColumnStatisticsData).

  Datos estadísticos de columnas booleanas.
+ `DateColumnStatisticsData`: un objeto [DateColumnStatisticsData](#aws-glue-api-common-DateColumnStatisticsData).

  Datos estadísticos de columnas de fecha.
+ `DecimalColumnStatisticsData`: un objeto [DecimalColumnStatisticsData](#aws-glue-api-common-DecimalColumnStatisticsData).

   Datos estadísticos columnas de decimales. UnscaledValues dentro son objetos binarios codificados en Base64 que almacenan representaciones big-endian, complementarias de dos, del valor sin escala del decimal. 
+ `DoubleColumnStatisticsData`: un objeto [DoubleColumnStatisticsData](#aws-glue-api-common-DoubleColumnStatisticsData).

  Datos estadísticos de doble columna.
+ `LongColumnStatisticsData`: un objeto [LongColumnStatisticsData](#aws-glue-api-common-LongColumnStatisticsData).

  Datos estadísticos de columna larga.
+ `StringColumnStatisticsData`: un objeto [StringColumnStatisticsData](#aws-glue-api-common-StringColumnStatisticsData).

  Datos estadísticos de columnas de cadena.
+ `BinaryColumnStatisticsData`: un objeto [BinaryColumnStatisticsData](#aws-glue-api-common-BinaryColumnStatisticsData).

  Datos estadísticos de columnas binarias.

## Estructura BooleanColumnStatisticsData
<a name="aws-glue-api-common-BooleanColumnStatisticsData"></a>

Define las estadísticas de columna soportadas para las columnas de datos booleanos.

**Fields**
+ `NumberOfTrues` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores verdaderos en la columna.
+ `NumberOfFalses` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores falsos en la columna.
+ `NumberOfNulls` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores nulos en la columna.

## Estructura DateColumnStatisticsData
<a name="aws-glue-api-common-DateColumnStatisticsData"></a>

Define las estadísticas de columna soportadas para las columnas de datos de marca temporal.

**Fields**
+ `MinimumValue`: marca temporal.

  El valor más bajo de la columna.
+ `MaximumValue`: marca temporal.

  El valor más alto de la columna.
+ `NumberOfNulls` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores nulos en la columna.
+ `NumberOfDistinctValues` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores distintos de una columna.

## Estructura DecimalColumnStatisticsData
<a name="aws-glue-api-common-DecimalColumnStatisticsData"></a>

Define las estadísticas de columna soportadas para las columnas de datos de números con coma fija.

**Fields**
+ `MinimumValue`: un objeto [DecimalNumber](#aws-glue-api-common-DecimalNumber).

  El valor más bajo de la columna.
+ `MaximumValue`: un objeto [DecimalNumber](#aws-glue-api-common-DecimalNumber).

  El valor más alto de la columna.
+ `NumberOfNulls` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores nulos en la columna.
+ `NumberOfDistinctValues` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores distintos de una columna.

## Estructura DoubleColumnStatisticsData
<a name="aws-glue-api-common-DoubleColumnStatisticsData"></a>

Define las estadísticas de columna soportadas para las columnas de datos de números con coma flotante.

**Fields**
+ `MinimumValue`: número (doble).

  El valor más bajo de la columna.
+ `MaximumValue`: número (doble).

  El valor más alto de la columna.
+ `NumberOfNulls` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores nulos en la columna.
+ `NumberOfDistinctValues` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores distintos de una columna.

## Estructura LongColumnStatisticsData
<a name="aws-glue-api-common-LongColumnStatisticsData"></a>

Define las estadísticas de columna soportadas para las columnas de datos enteros.

**Fields**
+ `MinimumValue`: número (largo).

  El valor más bajo de la columna.
+ `MaximumValue`: número (largo).

  El valor más alto de la columna.
+ `NumberOfNulls` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores nulos en la columna.
+ `NumberOfDistinctValues` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores distintos de una columna.

## Estructura StringColumnStatisticsData
<a name="aws-glue-api-common-StringColumnStatisticsData"></a>

Define estadísticas de columna admitidas para valores de datos de secuencia de caracteres.

**Fields**
+ `MaximumLength` – *Obligatorio:* número (largo), cero como máximo.

  El tamaño de la cadena más larga de la columna.
+ `AverageLength` – *Obligatorio:* número (doble), cero como máximo.

  La longitud media de la cadena en la columna.
+ `NumberOfNulls` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores nulos en la columna.
+ `NumberOfDistinctValues` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores distintos de una columna.

## Estructura BinaryColumnStatisticsData
<a name="aws-glue-api-common-BinaryColumnStatisticsData"></a>

Define estadísticas de columna soportadas para valores de datos de secuencia de bits.

**Fields**
+ `MaximumLength` – *Obligatorio:* número (largo), cero como máximo.

  El tamaño de la secuencia de bits más larga de la columna.
+ `AverageLength` – *Obligatorio:* número (doble), cero como máximo.

  La longitud media de secuencia de bits en la columna.
+ `NumberOfNulls` – *Obligatorio:* número (largo), cero como máximo.

  El número de valores nulos en la columna.

## Patrones de cadena
<a name="aws-glue-api-common-_string-patterns"></a>

La API utiliza las siguientes expresiones regulares para definir qué es un contenido válido para diversos miembros y parámetros de cadena:
+ Patrón de cadena de línea única – "`[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*`"
+ Patrón de cadena de varias líneas de la dirección URI – "`[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`"
+ Patrón de cadena Grok Logstash – "`[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\t]*`"
+ Patrón de cadena del identificador – "`[A-Za-z_][A-Za-z0-9_]*`"
+ Patrón de cadena de ARN de AWS IAM – "`arn:aws:iam::\d{12}:role/.*`"
+ Patrón de cadena de versión – "`^[a-zA-Z0-9-_]+$`"
+ Patrón de cadena de grupo de registros – "`[\.\-_/#A-Za-z0-9]+`"
+ Patrón de cadena de flujo de registro – "`[^:*]*`"
+ Patrón de cadena personalizado n.º \#10 – "`[a-zA-Z0-9-_]+`"
+ Patrón de cadena personalizado n.º \#11 – "`[-a-zA-Z0-9+=/:_]*`"
+ Patrón de cadena personalizado n.º \#12 – "`[\S\s]*`"
+ Patrón de cadena personalizado n.º \#13 – "`.*\S.*`"
+ Patrón de cadena personalizado n.º \#14 – "`[a-zA-Z0-9-=._/@]+`"
+ Patrón de cadena personalizado n.º \#15 – "`[1-9][0-9]*|[1-9][0-9]*-[1-9][0-9]*`"
+ Patrón de cadena personalizado n.º \#16 – "`[A-Z][A-Za-z\.]+`"
+ Patrón de cadena personalizado n.º \#17 – "`[\S]*`"
+ Patrón de cadena personalizado n.º \#18 – "`[\w]*`"
+ Patrón de cadena personalizado n.º \#19 – "`arn:aws[a-z\-]*:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`"
+ Patrón de cadena personalizado n.º \#20 – "`subnet-[a-z0-9]+`"
+ Patrón de cadena personalizado n.º \#21 – "`\d{12}`"
+ Patrón de cadena personalizado n.º \#22 – "`([a-z]+)-([a-z]+-)?([a-z]+)-[0-9]+[a-z]+`"
+ Patrón de cadena personalizado n.º \#23 – "`[a-zA-Z0-9.-]*`"
+ Patrón de cadena personalizado n.º \#24 – "`arn:aws[a-z0-9\-]*:lambda:[a-z0-9\-]+:\d{12}:function:([\w\-]{1,64})`"
+ Patrón de cadena personalizado n.º \#25 – "`^(?!(.*[.\/\\]|aws:)).*$`"
+ Patrón de cadena personalizado n.º \#26 – "`[^\r\n]`"
+ Patrón de cadena personalizado n.º \#27 – "`^\w+\.\w+\.\w+$`"
+ Patrón de cadena personalizado n.º \#28 – "`^\w+\.\w+$`"
+ Patrón de cadena personalizado n.º \#29 – "`^$|arn:aws[a-z0-9-]*:kms:.*`"
+ Patrón de cadena personalizado n.º \#30 – "`arn:aws[^:]*:iam::[0-9]*:role/.+`"
+ Patrón de cadena personalizado n.º \#31 – "`[\.\-_A-Za-z0-9]+`"
+ Patrón de cadena personalizado n.º \#32 – "`^s3://([^/]+)/([^/]+/)*([^/]+)$`"
+ Patrón de cadena personalizado n.º \#33 – "`.*`"
+ Patrón de cadena personalizado n.º \#34 – "`^(Sun|Mon|Tue|Wed|Thu|Fri|Sat):([01]?[0-9]|2[0-3])$`"
+ Patrón de cadena personalizado n.º \#35 – "`[a-zA-Z0-9_.-]+`"
+ Patrón de cadena personalizado N.º \#36 – "`^arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:secretsmanager:.*$`"
+ Patrón de cadena personalizado N.º \#37 – "`\S+`"
+ Patrón de cadena personalizado N.º \#38 – "`^[\x20-\x7E]*$`"
+ Patrón de cadena personalizado N.º \#39 – "`^([a-zA-Z0-9_=]+)\.([a-zA-Z0-9_=]+)\.([a-zA-Z0-9_\-\+\/=]*)`"
+ Patrón de cadena personalizado N.º \#40 – "`^(https?)://[-a-zA-Z0-9+&@#/%?=~_|!:,.;]*[-a-zA-Z0-9+&@#/%=~_|]`"
+ Patrón de cadena personalizado N.º \#41 – "`^(https?):\/\/[^\s/$.?#].[^\s]*$`"
+ Patrón de cadena personalizado N.º \#42 – "`arn:aws:kms:.*`"
+ Patrón de cadena personalizado N.º \#43 – "`^subnet-[a-z0-9]+$`"
+ Patrón de cadena personalizado N.º \#44 – "`[\p{L}\p{N}\p{P}]*`"
+ Patrón de cadena personalizado N.º \#45 – "`[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`"
+ Patrón de cadena personalizado N.º \#46 – "`[a-zA-Z0-9-_$#.]+`"
+ Patrón de cadena personalizado N.º \#47 – "`^\d{12}$`"
+ Patrón de cadena personalizado N.º \#48 – "`^(\w+\.)+\w+$`"
+ Patrón de cadena personalizado N.º \#49 – "`^([2-3]|3[.]9)$`"
+ Patrón de cadena personalizado N.º \#50 – "`arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:glue:.*`"
+ Patrón de cadena personalizado N.º \#51 – "`[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}`"
+ Patrón de cadena personalizado N.º \#52 – "`(^arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:iam::\w{12}:root)`"
+ Patrón de cadena personalizado N.º \#53 – "`^arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:iam::[0-9]{12}:role/.+`"
+ Patrón de cadena personalizado N.º \#54 – "`[\s\S]*`"
+ Patrón de cadena personalizado N.º \#55 – "`([\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF]|[^\S\r\n"'= ;])*`"
+ Patrón de cadena personalizado N.º \#56 – "`^[A-Z\_]+$`"
+ Patrón de cadena personalizado N.º \#57 – "`^[A-Za-z0-9]+$`"
+ Patrón de cadena personalizado N.º \#58 – "`[*A-Za-z0-9_-]*`"
+ Patrón de cadena personalizado N.º \#59 – "`([\u0020-\u007E\r\s\n])*`"
+ Patrón de cadena personalizado N.º \#60 – "`[A-Za-z0-9_-]*`"
+ Patrón de cadena personalizado N.º \#61 – "`([\u0009\u000B\u000C\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF])*`"
+ Patrón de cadena personalizado N.º \#62 – "`([\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\s])*`"
+ Patrón de cadena personalizado n.º \#63 – "`([^\r\n])*`"