

 Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del parche 198. Las UDF de Python existentes seguirán funcionando hasta el 30 de junio de 2026. Para obtener más información, consulte la [publicación del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Función OBJECT\$1TRANSFORM
<a name="r_object_transform_function"></a>

Transforma un objeto SUPER.

## Sintaxis
<a name="r_object_transform_function-synopsis"></a>

```
OBJECT_TRANSFORM(
  input
  [KEEP path1, ...]
  [SET
    path1, value1,
    ...,  ...
  ]
)
```

## Argumentos
<a name="r_object_transform_function-arguments"></a>

*Entrada de*  
Expresión que se convierte en un objeto de tipo SUPER.

*KEEP*  
Todos los valores de *path* especificados en esta cláusula se conservan y se trasladan al objeto de salida.  
Esta cláusula es opcional.

*path1*, *path2*, ...  
Literales de cadena constantes, en formato de componentes de ruta entre comillas dobles delimitados por puntos. Por ejemplo, `'"a"."b"."c"'` es un valor válido. Esto se aplica al parámetro path de las cláusulas KEEP y SET.

*SET*  
Pares de *path* y *value* para modificar una ruta existente o añadir una nueva y establecer el valor de esa ruta en el objeto de salida.  
Esta cláusula es opcional.

*value1*, *value2*, ...  
Expresiones que se resuelven en valores de tipo SUPER. Tenga en cuenta que los tipos numérico, de texto y booleano se pueden resolver en SUPER.

## Tipo de retorno
<a name="r_object_transform_function-returns"></a>

`SUPER`

## Notas de uso
<a name="r_object_transform_function-usage-notes"></a>

OBJECT\$1TRANSFORM devuelve un objeto de tipo SUPER que contiene los valores de ruta *input* que se han especificado en KEEP y los pares de *path* y *value* que se han especificado en SET. 

Si tanto KEEP como SET están vacíos, OBJECT\$1TRANSFORM devuelve *input*.

Si *input* no es un *object* de tipo SUPER, OBJECT\$1TRANSFORM devuelve *input*, independientemente de los valores KEEP o SET.

## Ejemplo
<a name="r_object_transform_function-example"></a>

En el siguiente ejemplo se transforma un objeto SUPER en otro objeto SUPER.

```
CREATE TABLE employees (
    col_person SUPER
);

INSERT INTO employees
VALUES
    (
        json_parse('
            {
                "name": {
                    "first": "John",
                    "last": "Doe"
                },
                "age": 25,
                "ssn": "111-22-3333",
                "company": "Company Inc.",
                "country": "U.S."
            }
        ')
    ),
    (
        json_parse('
            {
                "name": {
                    "first": "Jane",
                    "last": "Appleseed"
                },
                "age": 34,
                "ssn": "444-55-7777",
                "company": "Organization Org.",
                "country": "Ukraine"
            }
        ')
    )
;

SELECT
    OBJECT_TRANSFORM(
        col_person
        KEEP
            '"name"."first"',
            '"age"',
            '"company"',
            '"country"'
        SET
            '"name"."first"', UPPER(col_person.name.first::TEXT),
            '"age"', col_person.age + 5,
            '"company"', 'Amazon'
    ) AS col_person_transformed
FROM employees;
    
--This result is formatted for ease of reading.
                  col_person_transformed
-------------------------------------------------------------
{
    "name": {
        "first": "JOHN"
    },
    "age": 30,
    "company": "Amazon",
    "country": "U.S."
}
{
    "name": {
        "first": "JANE"
    },
    "age": 39,
    "company": "Amazon",
    "country": "Ukraine"
}
```