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/).
# Comandos SQL
El lenguaje SQL consta de comandos que se utilizan para crear y manipular objetos de base de datos, ejecutar consultas, cargar tablas y modificar los datos de las tablas.
Amazon Redshift se basa en PostgreSQL. Amazon Redshift y PostgreSQL tienen una serie de diferencias significativas que debe tener en cuenta a la hora de diseñar y desarrollar aplicaciones de almacenamiento de datos. Para obtener más información acerca de las diferencias entre Amazon Redshift SQL y PostgreSQL, consulte [Amazon Redshift y PostgreSQL](c_redshift-and-postgres-sql.md).
**nota**
El tamaño máximo de una instrucción SQL es de 16 MB.
**Topics**
+ [ABORT](r_ABORT.md)
+ [ALTER DATABASE](r_ALTER_DATABASE.md)
+ [ALTER DATASHARE](r_ALTER_DATASHARE.md)
+ [ALTER DEFAULT PRIVILEGES](r_ALTER_DEFAULT_PRIVILEGES.md)
+ [ALTER EXTERNAL SCHEMA](r_ALTER_EXTERNAL_SCHEMA.md)
+ [ALTER EXTERNAL VIEW](r_ALTER_EXTERNAL_VIEW.md)
+ [ALTER FUNCTION](r_ALTER_FUNCTION.md)
+ [ALTER GROUP](r_ALTER_GROUP.md)
+ [MODIFICAR PROVEEDOR DE IDENTIDADES](r_ALTER_IDENTITY_PROVIDER.md)
+ [ALTER MASKING POLICY](r_ALTER_MASKING_POLICY.md)
+ [ALTER MATERIALIZED VIEW](r_ALTER_MATERIALIZED_VIEW.md)
+ [ALTER RLS POLICY](r_ALTER_RLS_POLICY.md)
+ [ALTER ROLE](r_ALTER_ROLE.md)
+ [ALTER PROCEDURE](r_ALTER_PROCEDURE.md)
+ [ALTER SCHEMA](r_ALTER_SCHEMA.md)
+ [ALTER SYSTEM](r_ALTER_SYSTEM.md)
+ [ALTER TABLE](r_ALTER_TABLE.md)
+ [ALTER TABLE APPEND](r_ALTER_TABLE_APPEND.md)
+ [ALTER TEMPLATE](r_ALTER_TEMPLATE.md)
+ [ALTER USER](r_ALTER_USER.md)
+ [ANALYZE](r_ANALYZE.md)
+ [ANALYZE COMPRESSION](r_ANALYZE_COMPRESSION.md)
+ [ATTACH MASKING POLICY](r_ATTACH_MASKING_POLICY.md)
+ [ATTACH RLS POLICY](r_ATTACH_RLS_POLICY.md)
+ [BEGIN](r_BEGIN.md)
+ [CALL](r_CALL_procedure.md)
+ [CANCEL](r_CANCEL.md)
+ [CLOSE](close.md)
+ [COMMENT](r_COMMENT.md)
+ [COMMIT](r_COMMIT.md)
+ [COPY](r_COPY.md)
+ [CREATE DATABASE](r_CREATE_DATABASE.md)
+ [CREATE DATASHARE](r_CREATE_DATASHARE.md)
+ [CREATE EXTERNAL FUNCTION](r_CREATE_EXTERNAL_FUNCTION.md)
+ [CREATE EXTERNAL MODEL](r_create_external_model.md)
+ [CREATE EXTERNAL SCHEMA](r_CREATE_EXTERNAL_SCHEMA.md)
+ [CREATE EXTERNAL TABLE](r_CREATE_EXTERNAL_TABLE.md)
+ [CREATE EXTERNAL VIEW](r_CREATE_EXTERNAL_VIEW.md)
+ [CREATE FUNCTION](r_CREATE_FUNCTION.md)
+ [CREATE GROUP](r_CREATE_GROUP.md)
+ [CREATE IDENTITY PROVIDER](r_CREATE_IDENTITY_PROVIDER.md)
+ [CREATE LIBRARY](r_CREATE_LIBRARY.md)
+ [CREATE MASKING POLICY](r_CREATE_MASKING_POLICY.md)
+ [CREATE MATERIALIZED VIEW](materialized-view-create-sql-command.md)
+ [CREATE MODEL](r_CREATE_MODEL.md)
+ [CREATE PROCEDURE](r_CREATE_PROCEDURE.md)
+ [CREATE RLS POLICY](r_CREATE_RLS_POLICY.md)
+ [CREATE ROLE](r_CREATE_ROLE.md)
+ [CREATE SCHEMA](r_CREATE_SCHEMA.md)
+ [CREATE TABLE](r_CREATE_TABLE_NEW.md)
+ [CREATE TABLE AS](r_CREATE_TABLE_AS.md)
+ [CREATE TEMPLATE](r_CREATE_TEMPLATE.md)
+ [CREATE USER](r_CREATE_USER.md)
+ [CREATE VIEW](r_CREATE_VIEW.md)
+ [DEALLOCATE](r_DEALLOCATE.md)
+ [DECLARE](declare.md)
+ [DELETE](r_DELETE.md)
+ [DESC DATASHARE](r_DESC_DATASHARE.md)
+ [DESC IDENTITY PROVIDER](r_DESC_IDENTITY_PROVIDER.md)
+ [DETACH MASKING POLICY](r_DETACH_MASKING_POLICY.md)
+ [DETACH RLS POLICY](r_DETACH_RLS_POLICY.md)
+ [DROP DATABASE](r_DROP_DATABASE.md)
+ [DROP DATASHARE](r_DROP_DATASHARE.md)
+ [DROP EXTERNAL VIEW](r_DROP_EXTERNAL_VIEW.md)
+ [DROP FUNCTION](r_DROP_FUNCTION.md)
+ [DROP GROUP](r_DROP_GROUP.md)
+ [DROP IDENTITY PROVIDER](r_DROP_IDENTITY_PROVIDER.md)
+ [DROP LIBRARY](r_DROP_LIBRARY.md)
+ [DROP MASKING POLICY](r_DROP_MASKING_POLICY.md)
+ [DROP MODEL](r_DROP_MODEL.md)
+ [DROP MATERIALIZED VIEW](materialized-view-drop-sql-command.md)
+ [DROP PROCEDURE](r_DROP_PROCEDURE.md)
+ [DROP RLS POLICY](r_DROP_RLS_POLICY.md)
+ [DROP ROLE](r_DROP_ROLE.md)
+ [DROP SCHEMA](r_DROP_SCHEMA.md)
+ [DROP TABLE](r_DROP_TABLE.md)
+ [DROP TEMPLATE](r_DROP_TEMPLATE.md)
+ [DROP USER](r_DROP_USER.md)
+ [DROP VIEW](r_DROP_VIEW.md)
+ [END](r_END.md)
+ [EXECUTE](r_EXECUTE.md)
+ [EXPLAIN](r_EXPLAIN.md)
+ [FETCH](fetch.md)
+ [GRANT](r_GRANT.md)
+ [INSERT](r_INSERT_30.md)
+ [INSERT (tabla externa)](r_INSERT_external_table.md)
+ [LOCK](r_LOCK.md)
+ [MERGE](r_MERGE.md)
+ [PREPARE](r_PREPARE.md)
+ [REFRESH MATERIALIZED VIEW](materialized-view-refresh-sql-command.md)
+ [RESET](r_RESET.md)
+ [REVOKE](r_REVOKE.md)
+ [ROLLBACK](r_ROLLBACK.md)
+ [SELECT](r_SELECT_synopsis.md)
+ [SELECT INTO](r_SELECT_INTO.md)
+ [SET](r_SET.md)
+ [SET SESSION AUTHORIZATION](r_SET_SESSION_AUTHORIZATION.md)
+ [SET SESSION CHARACTERISTICS](r_SET_SESSION_CHARACTERISTICS.md)
+ [SHOW](r_SHOW.md)
+ [SHOW COLUMN GRANTS](r_SHOW_COLUMN_GRANTS.md)
+ [SHOW COLUMNS](r_SHOW_COLUMNS.md)
+ [SHOW CONSTRAINTS](r_SHOW_CONSTRAINTS.md)
+ [SHOW EXTERNAL TABLE](r_SHOW_EXTERNAL_TABLE.md)
+ [SHOW DATABASES](r_SHOW_DATABASES.md)
+ [SHOW FUNCTIONS](r_SHOW_FUNCTIONS.md)
+ [SHOW GRANTS](r_SHOW_GRANTS.md)
+ [SHOW MODEL](r_SHOW_MODEL.md)
+ [SHOW DATASHARES](r_SHOW_DATASHARES.md)
+ [SHOW PARAMETERS](r_SHOW_PARAMETERS.md)
+ [SHOW POLICIES](r_SHOW_POLICIES.md)
+ [SHOW PROCEDURE](r_SHOW_PROCEDURE.md)
+ [SHOW PROCEDURES](r_SHOW_PROCEDURES.md)
+ [MOSTRAR ESQUEMAS](r_SHOW_SCHEMAS.md)
+ [SHOW TABLE](r_SHOW_TABLE.md)
+ [SHOW TABLES](r_SHOW_TABLES.md)
+ [SHOW TEMPLATE](r_SHOW_TEMPLATE.md)
+ [SHOW TEMPLATES](r_SHOW_TEMPLATES.md)
+ [SHOW VIEW](r_SHOW_VIEW.md)
+ [START TRANSACTION](r_START_TRANSACTION.md)
+ [TRUNCATE](r_TRUNCATE.md)
+ [UNLOAD](r_UNLOAD.md)
+ [UPDATE](r_UPDATE.md)
+ [USE](r_USE_command.md)
+ [VACUUM](r_VACUUM_command.md)
# ABORT
Detiene la transacción que se está ejecutando en ese momento y descarta todas las actualizaciones realizadas por esa transacción. ABORT no tiene efecto en transacciones que ya están completadas.
Este comando lleva a cabo la misma función que el comando ROLLBACK. Para obtener más información, consulte [ROLLBACK](r_ROLLBACK.md).
## Sintaxis
```
ABORT [ WORK | TRANSACTION ]
```
## Parameters
WORK
Palabra clave opcional.
TRANSACTION
Palabra clave opcional; WORK y TRANSACTION son sinónimos.
## Ejemplo
En el siguiente ejemplo, se crea una tabla que inicia una transacción donde los datos se insertan en la tabla. Luego, el comando ABORT revierte la inserción de datos para dejar la tabla vacía.
El siguiente comando crea una tabla de ejemplo denominada MOVIE\$1GROSS:
```
create table movie_gross( name varchar(30), gross bigint );
```
El siguiente conjunto de comandos inicia una transacción en donde se insertan dos filas de datos en la tabla:
```
begin;
insert into movie_gross values ( 'Raiders of the Lost Ark', 23400000);
insert into movie_gross values ( 'Star Wars', 10000000 );
```
A continuación, el siguiente comando selecciona los datos de la tabla para mostrar que se insertaron correctamente:
```
select * from movie_gross;
```
El resultado del comando muestra que ambas filas se insertaron correctamente:
```
name | gross
------------------------+----------
Raiders of the Lost Ark | 23400000
Star Wars | 10000000
(2 rows)
```
Este comando ahora revierte los cambios de datos para que vuelvan al estado de inicio de la transacción:
```
abort;
```
Si selecciona los datos de la tabla, ahora se muestra una tabla vacía:
```
select * from movie_gross;
name | gross
------+-------
(0 rows)
```
# ALTER DATABASE
Cambia los atributos de una base de datos.
## Privilegios necesarios
Para utilizar ALTER DATABASE, se requiere uno de los siguientes privilegios.
+ Superusuario
+ Usuarios con el privilegio ALTER DATABASE
+ Propietario de la base de datos
## Sintaxis
```
ALTER DATABASE database_name
{
RENAME TO new_name
| OWNER TO new_owner
| [ CONNECTION LIMIT { limit | UNLIMITED } ]
[ COLLATE { CASE_SENSITIVE | CS | CASE_INSENSITIVE | CI } ]
[ ISOLATION LEVEL { SNAPSHOT | SERIALIZABLE } ]
| INTEGRATION
{
REFRESH { { ALL | INERROR } TABLES [ IN SCHEMA schema [, ...] ] | TABLE schema.table [, ...] }
| SET
[ QUERY_ALL_STATES [=] { TRUE | FALSE } ]
[ ACCEPTINVCHARS [=] { TRUE | FALSE } ]
[ REFRESH_INTERVAL ]
[ TRUNCATECOLUMNS [=] { TRUE | FALSE } ]
[ HISTORY_MODE [=] {TRUE | FALSE} [ FOR { {ALL} TABLES [IN SCHEMA schema [, ...] ] | TABLE schema.table [, ...] } ] ]
}
}
```
## Parameters
*database\$1name*
Nombre de la base de datos que se modificará. Por lo general, modifica una base de datos a la que no está actualmente conectado. De todos modos, los cambios entran en vigor únicamente en sesiones posteriores. Puede cambiar el propietario de la base de datos actual, pero no puede cambiar su nombre:
```
alter database tickit rename to newtickit;
ERROR: current database may not be renamed
```
RENAME TO
Cambia el nombre de la base de datos especificada. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md). No puede cambiar el nombre de las bases de datos dev, padb\$1harvest, template0, template1 o sys:internal, ni puede cambiar el nombre de la base de datos actual. Solo el propietario de la base de datos o un [superuser](r_superusers.md#def_superusers) puede cambiar el nombre de una base de datos; los propietarios que no son superusuarios deben tener también el privilegio CREATEDB.
*new\$1name*
Nuevo nombre de la base de datos.
OWNER TO
Cambia el propietario de la base de datos especificada. Puede cambiar el propietario de la base de datos actual o alguna otra base de datos. Solo un superusuario puede cambiar el propietario.
*new\$1owner*
Nuevo propietario de la base de datos. El nuevo propietario debe ser un usuario de la base de datos existente con privilegios de escritura. Para obtener más información acerca de los privilegios del usuario, consulte [GRANT](r_GRANT.md).
CONNECTION LIMIT \$1 *limit* \$1 UNLIMITED \$1
La cantidad máxima de conexiones a la base de datos que los usuarios pueden tener abiertas al mismo tiempo. Este límite no se aplica a los superusuarios. Use la palabra clave UNLIMITED para permitir la cantidad máxima de conexiones simultáneas. También puede aplicarse un límite de la cantidad de conexiones de cada usuario. Para obtener más información, consulte [CREATE USER](r_CREATE_USER.md). El valor predeterminado es UNLIMITED. Para ver las conexiones actuales, consulte la vista del sistema [STV\$1SESSIONS](r_STV_SESSIONS.md).
Si se aplican los límites de conexión tanto para usuarios como para bases de datos, debe haber una ranura de conexión sin utilizar disponible dentro de ambos límites cuando un usuario intenta conectarse.
COLLATE \$1 CASE\$1SENSITIVE \$1 CS \$1 CASE\$1INSENSITIVE \$1 CI \$1
Se trata de una cláusula que especifica si la búsqueda o la comparación de cadenas distinguen o no entre letras mayúsculas y minúsculas.
Puede cambiar la distinción entre mayúsculas y minúsculas de la base de datos actual, incluso si está vacía.
Debe tener permiso ALTER para la base de datos actual a fin de cambiar la distinción entre mayúsculas y minúsculas. Los superusuarios o propietarios de bases de datos con el permiso CREATE DATABASE también pueden cambiar la distinción entre mayúsculas y minúsculas de la base de datos.
CASE\$1SENSITIVE y CS son intercambiables y producen los mismos resultados. Del mismo modo, CASE\$1INSENSITIVE y CI son intercambiables y producen los mismos resultados.
ISOLATION LEVEL \$1 SNAPSHOT \$1 SERIALIZABLE \$1
Una cláusula que especifica el nivel de aislamiento utilizado cuando las consultas se ejecutan en una base de datos. Para obtener más información sobre niveles de aislamiento, consulte [Niveles de aislamiento en Amazon Redshift](c_serial_isolation.md).
+ Aislamiento SNAPSHOT: proporciona un nivel de aislamiento con protección contra conflictos de actualización y eliminación.
+ Aislamiento SERIALIZABLE: proporciona serialización completa para transacciones simultáneas.
Tenga en cuenta los siguientes aspectos al modificar el nivel de aislamiento de una base de datos:
+ Debe contar con el privilegio de superusuario o CREATE DATABASE en la base de datos actual para cambiar el nivel de aislamiento de la base de datos.
+ No puede modificar el nivel de aislamiento de la base de datos de `dev`.
+ No puede modificar el nivel de aislamiento dentro de un bloque de transacción.
+ El comando alter isolation level produce un error si otros usuarios están conectados a la base de datos.
+ El comando alter isolation level puede modificar la configuración del nivel de aislamiento de la sesión actual.
INTEGRATION
Modifique una base de datos de integración sin ETL.
REFRESH \$1\$1 ALL \$1 INERROR \$1 TABLES [IN SCHEMA *esquema* [, ...]] \$1 TABLE *esquema.tabla* [, ...]\$1
Una cláusula que especifica si Amazon Redshift actualizará todas las tablas o las que contengan errores en el esquema o la tabla especificados. La actualización hará que las tablas del esquema o tabla especificados se repliquen completamente desde la base de datos de origen.
Para obtener más información, consulte [Integraciones sin ETL](https://docs.aws.amazon.com/redshift/latest/mgmt/zero-etl-using.html) en la *Guía de administración de Amazon Redshift*. Para obtener más información acerca de los estados de integración, consulte [SVV\$1INTEGRATION\$1TABLE\$1STATE](r_SVV_INTEGRATION_TABLE_STATE.md) y [SVV\$1INTEGRATION](r_SVV_INTEGRATION.md).
QUERY\$1ALL\$1STATES [=] \$1 TRUE \$1 FALSE \$1
La cláusula QUERY\$1ALL\$1STATES establece si las tablas de integración sin ETL pueden consultarse en todos los estados (`Synced`, `Failed`, `ResyncRequired` y `ResyncInitiated`). De forma predeterminada, una tabla de integración sin ETL solo puede consultarse en estado `Synced`.
ACCEPTINVCHARS [=] \$1 TRUE \$1 FALSE \$1
La cláusula ACCEPTINVCHARS establece si las tablas de integración sin ETL continúan con la ingesta cuando se detectan caracteres no válidos para el tipo de datos VARCHAR. Cuando se encuentran caracteres no válidos, se reemplazan por un carácter `?` predeterminado.
REFRESH\$1INTERVAL
La cláusula REFRESH\$1INTERVAL establece el intervalo de tiempo aproximado, en segundos, para actualizar los datos desde el origen sin ETL en la base de datos de destino. El `interval` se puede establecer de 0 a 432 000 segundos (5 días) para las integraciones sin ETL cuyo tipo de origen sea Aurora MySQL, Aurora PostgreSQL o RDS para MySQL. Para las integraciones sin ETL de Amazon DynamoDB, se puede configurar el `interval` entre 900 y 432 000 segundos (15 minutos y 5 días).
Para obtener más información sobre la creación de bases de datos con integraciones sin ETL, consulte [Creación de bases de datos de destino en Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/zero-etl-using.creating-db.html) en la *Guía de administración de Amazon Redshift*.
TRUNCATECOLUMNS [=] \$1 TRUE \$1 FALSE \$1
La cláusula TRUNCATECOLUMNS establece si las tablas de integración sin ETL continúan con la ingesta cuando los valores de la columna VARCHAR o los atributos de columna SUPER exceden el límite. Cuando `TRUE`, los valores se truncan para que quepan en la columna y los valores de los atributos JSON desbordados se truncan para que quepan en la columna SUPER.
HISTORY\$1MODE [=] \$1TRUE \$1 FALSE\$1 [ FOR \$1 \$1ALL\$1 TABLES [IN SCHEMA esquema [, ...]] \$1 TABLE esquema.tabla [, ...]\$1 ]
Cláusula que especifica si Amazon Redshift establecerá el modo de historial para todas las tablas o las tablas del esquema especificado que participan en la integración sin ETL. Esta opción solo se aplica a las bases de datos creadas para la integración sin ETL.
La cláusula HISTORY\$1MODE puede establecerse en `TRUE` o `FALSE`. El valor predeterminado es `FALSE`. Activar y desactivar el modo de historial solo es aplicable a las tablas que se encuentran en el estado `Synced`. Para obtener información sobre HISTORY\$1MODE, consulte [Modo de historial](https://docs.aws.amazon.com/redshift/latest/mgmt/zero-etl-history-mode.html) en la *Guía de administración de Amazon Redshift*.
## Notas de uso
Los comandos ALTER DATABASE se aplican en sesiones posteriores, no en sesiones actuales. Debe volver a conectarse a la base de datos modificada para ver el efecto del cambio.
## Ejemplos
En el siguiente ejemplo, se cambia el nombre de una base de datos denominada TICKIT\$1SANDBOX a TICKIT\$1TEST:
```
alter database tickit_sandbox rename to tickit_test;
```
En el siguiente ejemplo, se cambia el propietario de la base de datos TICKIT (la base de datos actual) a DWUSER:
```
alter database tickit owner to dwuser;
```
En el siguiente ejemplo, se cambia la distinción entre letras mayúsculas y minúsculas de la base de datos sampledb:
```
ALTER DATABASE sampledb COLLATE CASE_INSENSITIVE;
```
En el siguiente ejemplo se modifica una base de datos denominada **sampledb** con nivel de aislamiento SNAPSHOT.
```
ALTER DATABASE sampledb ISOLATION LEVEL SNAPSHOT;
```
En el siguiente ejemplo se actualizan las tablas **schema1.sample\$1table1** y **schema2.sample\$1table2** de la base de datos **sample\$1integration\$1db** de la integración sin ETL.
```
ALTER DATABASE sample_integration_db INTEGRATION REFRESH TABLE schema1.sample_table1, schema2.sample_table2;
```
En el siguiente ejemplo se actualizan todas las tablas sincronizadas y con errores de la integración sin ETL.
```
ALTER DATABASE sample_integration_db INTEGRATION REFRESH ALL tables;
```
El siguiente ejemplo establece el intervalo de actualización para las integraciones sin ETL en 600 segundos.
```
ALTER DATABASE sample_integration_db INTEGRATION SET REFRESH_INTERVAL 600;
```
En el siguiente ejemplo se actualizan todas las tablas incluidas en el `ErrorState` del esquema **sample\$1schema**.
```
ALTER DATABASE sample_integration_db INTEGRATION REFRESH INERROR TABLES in SCHEMA sample_schema;
```
En el siguiente ejemplo se activa el modo de historial para la tabla `myschema.table1`.
```
ALTER DATABASE sample_integration_db INTEGRATION SET HISTORY_MODE = true FOR TABLE myschema.table1
```
En el siguiente ejemplo se activa el modo de historial para todas las tablas en `myschema`.
```
ALTER DATABASE sample_integration_db INTEGRATION SET HISTORY_MODE = true for ALL TABLES IN SCHEMA myschema
```
# ALTER DATASHARE
Cambia la definición de un datashare (recurso para compartir datos). Puede agregar objetos o quitarlos con ALTER DATASHARE. Solo puede cambiar un recurso compartido de datos en la base de datos actual. Agregue o elimine objetos de la base de datos asociada a un recurso compartido de datos. El propietario del datashare con los permisos necesarios sobre los objetos del datashare que se agregarán o se quitarán puede modificar el datashare.
## Privilegios necesarios
Los siguientes privilegios son necesarios para ALTER DATASHARE:
+ Superusuario.
+ Usuario con el privilegio ALTER DATASHARE.
+ Usuarios que tienen el privilegio ALTER u ALL en el recurso compartido de datos.
+ Para agregar objetos específicos a un recurso compartido de datos, los usuarios deben disponer del privilegio correspondiente sobre los objetos. En este caso, los usuarios deben ser propietarios de los objetos, o bien tener los privilegios SELECT, USAGE u ALL sobre ellos.
## Sintaxis
La sintaxis siguiente ilustra cómo agregar o quitar objetos al recurso compartido de datos.
```
ALTER DATASHARE datashare_name { ADD | REMOVE } {
TABLE schema.table [, ...]
| SCHEMA schema [, ...]
| FUNCTION schema.sql_udf (argtype,...) [, ...]
| ALL TABLES IN SCHEMA schema [, ...]
| ALL FUNCTIONS IN SCHEMA schema [, ...] }
```
La sintaxis siguiente ilustra cómo configurar las propiedades del recurso compartido de datos.
```
ALTER DATASHARE datashare_name {
[ SET PUBLICACCESSIBLE [=] TRUE | FALSE ]
[ SET INCLUDENEW [=] TRUE | FALSE FOR SCHEMA schema ] }
```
## Parameters
*datashare\$1name*
Se trata del nombre del datashare que se modificará.
ADD \$1 REMOVE
Se trata de una cláusula que especifica si se agregan o se quitan objetos del datashare.
TABLE *schema*.*table* [, ...]
Se trata del nombre de la tabla o la vista del esquema especificado que se agrega al datashare.
SCHEMA *schema* [, ...]
Se trata del nombre del esquema que se agrega al datashare.
FUNCTION *schema*.*sql\$1udf* (argtype,...) [, ...]
Se trata del nombre de la función definida por el usuario de SQL con tipos de argumentos que se agrega al recurso compartido de datos.
ALL TABLES IN SCHEMA *schema* [, ...]
Se trata de una cláusula que especifica si se agregan todas las tablas y las vistas del esquema especificado al datashare.
ALL FUNCTIONS IN SCHEMA *schema* [, ...] \$1
Se trata de una cláusula que especifica la incorporación de todas las funciones del esquema especificado al datashare.
[ SET PUBLICACCESSIBLE [=] TRUE \$1 FALSE ]
Se trata de una cláusula que especifica si un datashare se puede compartir con clústeres que sean accesibles públicamente.
[ SET INCLUDENEW [=] TRUE \$1 FALSE FOR SCHEMA *schema* ]
Se trata de una cláusula que especifica si se agregan futuras tablas, vistas o funciones definidas por el usuario (UDF) de SQL creadas en el esquema especificado al datashare. Las tablas, las vistas o las UDF de SQL actuales del esquema especificado no se agregan al datashare. Solo los superusuarios pueden modificar esta propiedad para cada par de esquema y datashare. De manera predeterminada, la cláusula INCLUDENEW es false.
## Notas de uso de ALTER DATASHARE
+ Los siguientes usuarios pueden modificar un datashare:
+ un superusuario
+ el propietario del datashare
+ usuarios que tienen privilegios ALTER o ALL en el recurso compartido de datos
+ Para agregar objetos específicos a un recurso compartido de datos, los usuarios deben disponer de los privilegios correspondientes sobre los objetos. Los usuarios deben ser los propietarios de los objetos o tener privilegios SELECT, USAGE u ALL sobre los objetos.
+ Puede compartir esquemas, tablas, vistas normales, vistas de enlace de tiempo de ejecución, vistas materializadas y funciones definidas por el usuario (UDF) de SQL. Primero, agregue un esquema al recurso compartido de datos antes de agregar otros objetos al esquema.
Cuando se agrega un esquema, Amazon Redshift no agrega todos los objetos que contiene. Se deben agregar de forma explícita.
+ Le recomendamos que cree recursos compartidos de datos de AWS Data Exchange con la configuración de acceso público activada.
+ En general, recomendamos que no modifique un recurso compartido de datos de AWS Data Exchange para desactivar la accesibilidad pública mediante la instrucción ALTER DATASHARE. En caso contrario, las Cuentas de AWS que tengan acceso al recurso compartido de datos lo pierden si sus clústeres son accesibles de manera pública. Realizar este tipo de alteración puede infringir los términos del producto de datos en AWS Data Exchange. Para obtener una excepción a esta recomendación, consulte lo siguiente.
El siguiente ejemplo muestra un error cuando se crea un recurso compartido de datos de AWS Data Exchange con la configuración desactivada.
```
ALTER DATASHARE salesshare SET PUBLICACCESSIBLE FALSE;
ERROR: Alter of ADX-managed datashare salesshare requires session variable datashare_break_glass_session_var to be set to value 'c670ba4db22f4b'
```
Para permitir la alteración de un recurso compartido de datos de AWS Data Exchange para desactivar la configuración de acceso público, configure la siguiente variable y ejecute de nuevo la instrucción ALTER DATASHARE.
```
SET datashare_break_glass_session_var to 'c670ba4db22f4b';
```
```
ALTER DATASHARE salesshare SET PUBLICACCESSIBLE FALSE;
```
En este caso, Amazon Redshift genera un valor aleatorio único para configurar la variable de sesión para permitir ALTER DATASHARE SET PUBLICACCESIBLE FALSE para un recurso compartido de datos de AWS Data Exchange.
## Ejemplos
En el siguiente ejemplo, se agrega el esquema `public` al recurso compartido de datos de `salesshare`.
```
ALTER DATASHARE salesshare ADD SCHEMA public;
```
En el siguiente ejemplo, se agregan todas las tablas de `public.tickit_sales_redshift` al recurso compartido de datos de `salesshare`.
```
ALTER DATASHARE salesshare ADD TABLE public.tickit_sales_redshift;
```
En el siguiente ejemplo, se agregan todas las tablas al recurso compartido de datos de `salesshare`.
```
ALTER DATASHARE salesshare ADD ALL TABLES IN SCHEMA PUBLIC;
```
En el siguiente ejemplo, se elimina la tabla de `public.tickit_sales_redshift` del recurso compartido de datos de `salesshare`.
```
ALTER DATASHARE salesshare REMOVE TABLE public.tickit_sales_redshift;
```
# ALTER DEFAULT PRIVILEGES
Define el conjunto de permisos de acceso predeterminado que se van a aplicar a los objetos que el usuario especificado cree en el futuro. De manera predeterminada, los usuarios pueden cambiar solo sus propios permisos de acceso predeterminados. Solo un superusuario puede especificar los permisos predeterminados de otros usuarios.
Puede aplicar privilegios predeterminados a roles, usuarios o grupos de usuarios. Puede configurar permisos predeterminados globalmente para todos los objetos creados en la base de datos actual o para objetos creados solo en los esquemas especificados.
Los permisos predeterminados se aplican solo a los objetos nuevos. Ejecutar ALTER DEFAULT PRIVILEGES no cambia los permisos de objetos existentes. Para conceder permisos a todos los objetos actuales y futuros creados por cualquier usuario dentro de una base de datos o un esquema, consulte [Permisos acotados](https://docs.aws.amazon.com/redshift/latest/dg/t_scoped-permissions.html).
Para ver información acerca de los privilegios predeterminados para usuarios de bases de datos, consulte la tabla de catálogo del sistema [PG\$1DEFAULT\$1ACL](r_PG_DEFAULT_ACL.md).
Para obtener más información acerca de los privilegios, consulte [GRANT](r_GRANT.md).
## Privilegios necesarios
Los siguientes privilegios son necesarios para ALTER DEFAULT PRIVILEGES:
+ Superusuario
+ Usuarios con el privilegio ALTER DEFAULT PRIVILEGES
+ Usuarios que cambien sus propios privilegios de acceso predeterminados
+ Usuarios que establezcan privilegios para esquemas para los que tienen privilegios de acceso
## Sintaxis
```
ALTER DEFAULT PRIVILEGES
[ FOR USER target_user [, ...] ]
[ IN SCHEMA schema_name [, ...] ]
grant_or_revoke_clause
where grant_or_revoke_clause is one of:
GRANT { { SELECT | INSERT | UPDATE | DELETE | DROP | REFERENCES | TRUNCATE } [,...] | ALL [ PRIVILEGES ] }
ON TABLES
TO { user_name [ WITH GRANT OPTION ] | ROLE role_name | GROUP group_name | PUBLIC } [, ...]
GRANT { EXECUTE | ALL [ PRIVILEGES ] }
ON FUNCTIONS
TO { user_name [ WITH GRANT OPTION ] | ROLE role_name | GROUP group_name | PUBLIC } [, ...]
GRANT { EXECUTE | ALL [ PRIVILEGES ] }
ON PROCEDURES
TO { user_name [ WITH GRANT OPTION ] | ROLE role_name | GROUP group_name | PUBLIC } [, ...]
REVOKE [ GRANT OPTION FOR ] { { SELECT | INSERT | UPDATE | DELETE | REFERENCES | TRUNCATE } [,...] | ALL [ PRIVILEGES ] }
ON TABLES
FROM user_name [, ...] [ RESTRICT ]
REVOKE { { SELECT | INSERT | UPDATE | DELETE | REFERENCES | TRUNCATE } [,...] | ALL [ PRIVILEGES ] }
ON TABLES
FROM { ROLE role_name | GROUP group_name | PUBLIC } [, ...] [ RESTRICT ]
REVOKE [ GRANT OPTION FOR ] { EXECUTE | ALL [ PRIVILEGES ] }
ON FUNCTIONS
FROM user_name [, ...] [ RESTRICT ]
REVOKE { EXECUTE | ALL [ PRIVILEGES ] }
ON FUNCTIONS
FROM { ROLE role_name | GROUP group_name | PUBLIC } [, ...] [ RESTRICT ]
REVOKE [ GRANT OPTION FOR ] { EXECUTE | ALL [ PRIVILEGES ] }
ON PROCEDURES
FROM user_name [, ...] [ RESTRICT ]
REVOKE { EXECUTE | ALL [ PRIVILEGES ] }
ON PROCEDURES
FROM { ROLE role_name | GROUP group_name | PUBLIC } [, ...] [ RESTRICT ]
```
## Parameters
FOR USER *target\$1user*
Opcional. El nombre del usuario para el que se definen los privilegios predeterminados. Solo un superusuario puede especificar los privilegios predeterminados de otros usuarios. El valor predeterminado es el usuario actual.
IN SCHEMA *schema\$1name*
Opcional. Si aparece una cláusula IN SCHEMA, los privilegios predeterminados especificados se aplican a objetos nuevos creados en el *schema\$1name* (nombre\$1de\$1esquema) especificado. En este caso, el usuario o grupo de usuarios que es destino de ALTER DEFAULT PRIVILEGES debe tener el privilegio CREATE para el esquema especificado. Los privilegios predeterminados que son específicos de un esquema se agregan a los privilegios predeterminados globales existentes. Por defecto, los privilegios predeterminados se aplican globalmente a toda la base de datos.
GRANT
Define el conjunto de privilegios que se concederá a los usuarios o grupos especificados para todas las tablas y vistas, funciones o procedimientos almacenados nuevos creados por el usuario especificado. Puede configurar los mismos privilegios y opciones con la cláusula GRANT que con el comando [GRANT](r_GRANT.md).
WITH GRANT OPTION
Una cláusula que indica que el usuario que recibe los privilegios puede, a cambio, concederles los mismos privilegios a otros. No puede conceder WITH GRANT OPTION a un grupo o a PUBLIC.
TO *user\$1name* \$1 ROLE *role\$1name* \$1 GROUP *group\$1name*
El nombre del usuario, rol o grupo de usuarios a los que se aplican los privilegios predeterminados especificados.
REVOKE
El conjunto de privilegios que se revocará de los usuarios o grupos especificados para todas las tablas, funciones o procedimientos almacenados creados por el usuario especificado. Puede configurar los mismos privilegios y opciones con la cláusula REVOKE que con el comando [REVOKE](r_REVOKE.md).
GRANT OPTION FOR
Una cláusula que revoca solo la opción de conceder un privilegio especificado a otros usuarios y no revoca el privilegio en sí. No puede revocar GRANT OPTION de un grupo o de PUBLIC.
FROM *user\$1name* \$1 ROLE *role\$1name* \$1 GROUP *group\$1name*
El nombre del usuario o grupo de usuarios de los que se revocan los privilegios especificados de manera predeterminada.
RESTRICT
La opción RESTRICT revoca solo aquellos privilegios que el usuario haya concedido directamente. Esta es la opción predeterminada.
## Ejemplos
Supongamos que desea permitir que cualquier usuario del grupo de usuarios `report_readers` vea todas las tablas y vistas creadas por el usuario `report_admin`. En este caso, ejecute el siguiente comando como superusuario.
```
alter default privileges for user report_admin grant select on tables to group report_readers;
```
En el siguiente ejemplo el primer comando concede privilegios SELECT en todas las tablas nuevas que usted crea. Cada vez que cree una vista nueva, debe conceder privilegios a la vista de forma explícita o volver a ejecutar el comando `alter default privileges`.
```
alter default privileges grant select on tables to public;
```
En el siguiente ejemplo, se concede un privilegio INSERT al grupo de usuarios `sales_admin` para todas las tablas y vistas nuevas que usted crea en el esquema `sales`.
```
alter default privileges in schema sales grant insert on tables to group sales_admin;
```
En el siguiente ejemplo, se revierte el comando ALTER DEFAULT PRIVILEGES del ejemplo anterior.
```
alter default privileges in schema sales revoke insert on tables from group sales_admin;
```
De manera predeterminada, el grupo de usuarios PUBLIC tiene permiso de ejecución para todas las funciones nuevas definidas por el usuario. Para revocar los permisos de ejecución `public` para las funciones nuevas y, luego, conceder el permiso de ejecución solo al grupo de usuarios `dev_test`, ejecute los siguientes comandos.
```
alter default privileges revoke execute on functions from public;
alter default privileges grant execute on functions to group dev_test;
```
# ALTER EXTERNAL SCHEMA
Modifica un esquema externo existente en la base de datos actual. Solo los propietarios del esquema, los superusuarios o los usuarios con privilegios ALTER en el esquema pueden modificarlo. Solo se pueden modificar los esquemas externos creados a partir de DATA CATALOG, KAFKA o MSK.
El propietario de este esquema es el emisor del comando CREATE EXTERNAL SCHEMA. Para transferir la propiedad de un esquema externo, use ALTER SCHEMA para cambiar el propietario. Para conceder acceso al esquema a otros usuarios o grupos de usuarios, utilice el comando GRANT.
No puede usar los comandos GRANT o REVOKE para los permisos en una tabla externa. En lugar de ello, conceda o revoque los permisos en el esquema externo.
Para obtener más información, consulte los siguientes temas:
+ [ALTER SCHEMA](r_ALTER_SCHEMA.md)
+ [GRANT](r_GRANT.md)
+ [REVOKE](r_REVOKE.md)
+ [CREATE EXTERNAL SCHEMA](r_CREATE_EXTERNAL_SCHEMA.md)
+ [Habilitación de la autenticación mTLS para un esquema externo existente](materialized-view-streaming-ingestion-mtls.md#materialized-view-streaming-ingestion-mtls-alter)
Para ver detalles de los esquemas externos, consulte la vista del sistema SVV\$1EXTERNAL\$1SCHEMAS. Para obtener más información, consulte [SVV\$1EXTERNAL\$1SCHEMAS](r_SVV_EXTERNAL_SCHEMAS.md).
## Sintaxis
```
ALTER EXTERNAL SCHEMA schema_name
[ IAM_ROLE [ default | 'SESSION' | 'arn:aws:iam:::role/' ] ]
[ AUTHENTICATION [ none | iam | mtls] ]
[ AUTHENTICATION_ARN 'acm-certificate-arn' | SECRET_ARN 'asm-secret-arn' ]
[ URI 'Kafka bootstrap URL' ]
```
Si tiene un esquema externo existente que utiliza para la ingesta de streaming y desea implementar un TLS mutuo para la autenticación, puede ejecutar un comando como el siguiente, que especifica la autenticación mTLS y el ARN del certificado ACM en ACM.
```
ALTER EXTERNAL SCHEMA schema_name
AUTHENTICATION mtls
AUTHENTICATION_ARN 'arn:aws:acm:us-east-1:444455556666:certificate/certificate_ID';
```
O bien, puede modificar la autenticación mTLS, con referencia al ARN del secreto en Secrets Manager.
```
ALTER EXTERNAL SCHEMA schema_name
AUTHENTICATION mtls
SECRET_ARN 'arn:aws:secretsmanager:us-east-1:012345678910:secret:myMTLSSecret';
```
El siguiente ejemplo muestra cómo modificar el URI para ALTER EXTERNAL SCHEMA:
```
ALTER EXTERNAL SCHEMA schema_name
URI 'lkc-ghidef-67890.centralus.azure.glb.confluent.cloud:9092';
```
El siguiente ejemplo muestra cómo modificar el rol de IAM para ALTER EXTERNAL SCHEMA:
```
ALTER EXTERNAL SCHEMA schema_name
IAM_ROLE 'arn:aws:iam::012345678901:role/testrole';
```
## Parameters
IAM\$1ROLE[ default \$1 'SESSION' \$1 'arn:aws:iam:::role/' ]
Utilice la palabra clave `default` para que Amazon Redshift utilice el rol de IAM establecido como predeterminado.
Use `'SESSION'` si se conecta al clúster de Amazon Redshift mediante una identidad federada y acceda a las tablas desde el esquema externo creado con este comando.
Para obtener más información, consulte [CREATE EXTERNAL SCHEMA](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_EXTERNAL_SCHEMA.html).
AUTENTICACIÓN
El tipo de autenticación que se ha definido para la ingesta de streaming. La ingesta de streaming con tipos de autenticación funciona con Apache Kafka, Confluent Cloud y Amazon Managed Streaming para Apache Kafka. Para obtener más información, consulte [CREATE EXTERNAL SCHEMA](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_EXTERNAL_SCHEMA.html).
AUTHENTICATION\$1ARN
El ARN del certificado de AWS Certificate Manager utilizado por Amazon Redshift para la autenticación mtls con Apache Kafka, Confluent Cloud o Amazon Managed Streaming para Apache Kafka (Amazon MSK). El ARN está disponible en la consola de ACM al elegir el certificado emitido.
SECRET\$1ARN
El nombre de recurso de Amazon (ARN) o un secreto compatible creado con AWS Secrets Manager. Para obtener información sobre cómo crear y recuperar un ARN para un secreto, consulte [Administrar secretos con AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) en la *Guía del usuario de AWS Secrets Manager*, y [Recuperar el nombre de recurso de Amazon (ARN) del secreto en Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-secrets-manager-integration-retrieving-secret.html).
URI
La URL de arranque del clúster de Apache Kafka, Confluent Cloud o Amazon Managed Streaming para Apache Kafka (Amazon MSK). El punto de conexión debe ser accesible (enrutable) desde el clúster de Amazon Redshift. Para obtener más información, consulte [CREATE EXTERNAL SCHEMA](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_EXTERNAL_SCHEMA.html).
# ALTER EXTERNAL VIEW
Utilice el comando ALTER EXTERNAL VIEW para actualizar la vista externa. Según los parámetros que utilice, es posible que también se vean afectados otros motores de SQL, como Amazon Athena y Amazon EMR Spark, que también pueden hacer referencia a esta vista. Para obtener más información sobre las vistas del Catálogo de datos, consulte [Vistas de AWS Glue Data Catalog](https://docs.aws.amazon.com/redshift/latest/dg/data-catalog-views-overview.html).
## Sintaxis
```
ALTER EXTERNAL VIEW schema_name.view_name
{catalog_name.schema_name.view_name | awsdatacatalog.dbname.view_name | external_schema_name.view_name}
[FORCE] { AS (query_definition) | REMOVE DEFINITION }
```
## Parameters
*schema\$1name.view\$1name*
Es el esquema asociado a la base de datos de AWS Glue, seguido del nombre de la vista.
catalog\$1name.schema\$1name.view\$1name \$1 awsdatacatalog.dbname.view\$1name \$1 external\$1schema\$1name.view\$1name
Es la notación del esquema que se utilizará al modificar la vista. Puede especificar el uso de AWS Glue Data Catalog, una base de datos de Glue que haya creado o un esquema externo que haya creado. Consulte [CREATE DATABASE](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_DATABASE.html) y [CREATE EXTERNAL SCHEMA ](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_EXTERNAL_SCHEMA.html)para obtener más información.
FORCE
Si AWS Lake Formation debe actualizar la definición de la vista incluso si los objetos a los que se hace referencia en la tabla no son coherentes con otros motores de SQL. Si Lake Formation actualiza la vista, esta se considera obsoleta para los demás motores de SQL hasta que dichos motores se actualicen.
*AS query\$1definition*
Es la definición de la consulta SQL que Amazon Redshift ejecuta para modificar la vista.
REMOVE DEFINITION
Si se deben eliminar las vistas y volver a crearlas. Las vistas deben suprimirse y volver a crearse para marcarlas como `PROTECTED`.
## Ejemplos
El siguiente ejemplo modifica una vista del catálogo de datos denominada sample\$1schema.glue\$1data\$1catalog\$1view.
```
ALTER EXTERNAL VIEW sample_schema.glue_data_catalog_view
FORCE
REMOVE DEFINITION
```
# ALTER FUNCTION
Cambia el nombre de una función o cambia el propietario. Se requieren tanto el nombre de la función como los tipos de datos. Solo el propietario o un superusuario pueden cambiar el nombre de una función. Solo un superusuario puede cambiar el propietario de una función.
## Sintaxis
```
ALTER FUNCTION function_name ( { [ py_arg_name py_arg_data_type | sql_arg_data_type } [ , ... ] ] )
RENAME TO new_name
```
```
ALTER FUNCTION function_name ( { [ py_arg_name py_arg_data_type | sql_arg_data_type } [ , ... ] ] )
OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
```
## Parameters
*function\$1name*
El nombre de la función que se va a alterar. Especifique el nombre de la función en la ruta de búsqueda actual o utilice el formato `schema_name.function_name` para usar un esquema específico.
*py\$1arg\$1name py\$1arg\$1data\$1type \$1 sql\$1arg\$1data\$1type*
Opcional. Una lista de nombres de argumentos de entrada y tipos de datos para la función definida por el usuario de Python o una lista de tipos de datos de argumentos de entrada para la función SQL definida por el usuario.
*new\$1name*
Un nuevo nombre para la función definida por el usuario.
*new\$1owner* \$1 CURRENT\$1USER \$1 SESSION\$1USER
Un nuevo propietario para la función definida por el usuario.
## Ejemplos
El siguiente ejemplo cambia el nombre de una función de `first_quarter_revenue` a `quarterly_revenue`.
```
ALTER FUNCTION first_quarter_revenue(bigint, numeric, int)
RENAME TO quarterly_revenue;
```
En el siguiente ejemplo, se modifica el propietario de la función `quarterly_revenue` a `etl_user`.
```
ALTER FUNCTION quarterly_revenue(bigint, numeric) OWNER TO etl_user;
```
# ALTER GROUP
Cambia un grupo de usuarios. Utilice este comando para agregar usuarios al grupo, eliminar usuarios del grupo o cambiar el nombre del grupo.
## Sintaxis
```
ALTER GROUP group_name
{
ADD USER username [, ... ] |
DROP USER username [, ... ] |
RENAME TO new_name
}
```
## Parameters
*group\$1name*
Nombre del grupo de usuarios que se modificará.
ADD
Agrega un usuario a un grupo de usuarios.
DROP
Elimina un usuario del grupo de usuarios.
*username*
Nombre del usuario que se agregará al grupo o que se eliminará del grupo.
RENAME TO
Cambia el nombre del grupo de usuarios. Los nombres de grupos que comienzan con dos guiones bajos se reservan para el uso interno de Amazon Redshift. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
*new\$1name*
Nuevo nombre del grupo de usuarios.
## Ejemplos
En el siguiente ejemplo, se agrega un usuario denominado DWUSER al grupo ADMIN\$1GROUP.
```
ALTER GROUP admin_group
ADD USER dwuser;
```
En el siguiente ejemplo, se cambia el nombre del grupo ADMIN\$1GROUP a ADMINISTRATORS.
```
ALTER GROUP admin_group
RENAME TO administrators;
```
En el siguiente ejemplo, se agrega un usuario denominado DWUSER al grupo ADMIN\$1GROUP.
```
ALTER GROUP admin_group
ADD USER u1, u2;
```
En el siguiente ejemplo se eliminan dos usuarios del grupo ADMIN\$1GROUP.
```
ALTER GROUP admin_group
DROP USER u1, u2;
```
# MODIFICAR PROVEEDOR DE IDENTIDADES
Modifica un proveedor de identidades para asignar nuevos parámetros y valores. Cuando ejecuta este comando, todos los valores de parámetros establecidos anteriormente se eliminan antes de asignarse los nuevos valores. Solo un superusuario puede modificar un proveedor de identidades.
## Sintaxis
```
ALTER IDENTITY PROVIDER identity_provider_name
[PARAMETERS parameter_string]
[NAMESPACE namespace]
[IAM_ROLE iam_role]
[AUTO_CREATE_ROLES
[ TRUE [ { INCLUDE | EXCLUDE } GROUPS LIKE filter_pattern] |
FALSE
]
[DISABLE | ENABLE]
```
## Parameters
*identity\$1provider\$1name*
Nombre del nuevo proveedor de identidades. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
*parameter\$1string*
Una cadena que contiene un objeto JSON con el formato correcto que contiene los parámetros y valores necesarios para el proveedor de identidades específico.
*Espacio de nombres de*
El espacio de nombres de la organización.
*iam\$1role*
El rol de IAM que proporciona permisos para la conexión al IAM Identity Center. Este parámetro solo se aplica cuando el tipo de proveedor de identidades es AWSIDC.
*auto\$1create\$1roles*
Habilita o deshabilita la característica de creación automática de roles. Si el valor es TRUE, Amazon Redshift habilita la característica de creación automática de roles. Si el valor es FALSE, Amazon Redshift desactiva la característica de creación automática de roles. Si no se especifica el valor de este parámetro, Amazon Redshift determina el valor mediante la siguiente lógica:
+ Si se proporciona `AUTO_CREATE_ROLES` pero no se especifica el valor, el valor se establece en TRUE.
+ Si no se proporciona `AUTO_CREATE_ROLES` y el proveedor de identidad es AWSIDC, el valor se establece en FALSE.
+ Si no se proporciona `AUTO_CREATE_ROLES` y el proveedor de identidad es Azure, el valor se establece en TRUE.
Para incluir grupos, especifique `INCLUDE`. El valor predeterminado es vacío, lo que significa incluir todos los grupos si `AUTO_CREATE_ROLES` está activado.
Para excluir grupos, especifique `EXCLUDE`. El valor predeterminado es vacío, lo que significa que no se excluirá ningún grupo si `AUTO_CREATE_ROLES` está activado.
*filter\$1pattern*
Una expresión de caracteres UTF-8 válida con un patrón para hacer coincidir los nombres de grupo. La opción LIKE realiza una coincidencia que distingue entre mayúsculas y minúsculas y admite los siguientes metacaracteres de coincidencia de patrones:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/r_ALTER_IDENTITY_PROVIDER.html)
Si *filter\$1pattern* no contiene metacaracteres, solo representa la propia cadena; en ese caso, LIKE actúa igual que el operador de igualdad.
*filter\$1pattern* admite los siguientes caracteres:
+ Caracteres alfabéticos en mayúsculas y minúsculas (A-Z y a-z)
+ Números (0-9)
+ Los siguientes caracteres especiales:
```
_ % ^ * + ? { } , $
```
*DISABLE o ENABLE*
Activa o desactiva un proveedor de identidades. El valor predeterminado es ENABLE.
## Ejemplos
En el siguiente ejemplo se modifica un proveedor de identidades denominado *oauth\$1standard*. Se aplica específicamente a los casos en que Microsoft Azure AD es el proveedor de identidades.
```
ALTER IDENTITY PROVIDER oauth_standard
PARAMETERS '{"issuer":"https://sts.windows.net/2sdfdsf-d475-420d-b5ac-667adad7c702/",
"client_id":"87f4aa26-78b7-410e-bf29-57b39929ef9a",
"client_secret":"BUAH~ewrqewrqwerUUY^%tHe1oNZShoiU7",
"audience":["https://analysis.windows.net/powerbi/connector/AmazonRedshift"]
}'
```
El siguiente ejemplo muestra cómo configurar el espacio de nombres del proveedor de identidades. Esto se puede aplicar a Microsoft Azure AD, si sigue una instrucción como la del ejemplo anterior o a otro proveedor de identidades. También se puede aplicar a los casos en los que conecte un clúster aprovisionado de Amazon Redshift o un grupo de trabajo de Amazon Redshift sin servidor existente a IAM Identity Center, si tiene una conexión configurada a través de una aplicación administrada.
```
ALTER IDENTITY PROVIDER "my-redshift-idc-application"
NAMESPACE 'MYCO';
```
El siguiente ejemplo establece el rol de IAM y funciona en el caso de uso para configurar la integración de Redshift con IAM Identity Center.
```
ALTER IDENTITY PROVIDER "my-redshift-idc-application"
IAM_ROLE 'arn:aws:iam::123456789012:role/myadministratorrole';
```
Para obtener más información sobre la configuración de una conexión de IAM Identity Center desde Redshift, consulte [Conectar Redshift con IAM Identity Center para ofrecer a los usuarios una experiencia de inicio de sesión único](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-idp-connect.html).
**Desactivación de un proveedor de identidades**
La instrucción de ejemplo siguiente muestra cómo desactivar un proveedor de identidades. Cuando está desactivado, los usuarios federados del proveedor de identidades no pueden iniciar sesión en el clúster hasta que se vuelva a habilitar.
```
ALTER IDENTITY PROVIDER "redshift-idc-app" DISABLE;
```
# ALTER MASKING POLICY
Modifica una política de enmascaramiento de datos dinámicos existente. Para obtener más información sobre el enmascaramiento dinámico de datos, consulte [Enmascaramiento de datos dinámico](t_ddm.md).
Los superusuarios y los usuarios o roles que tienen el rol sys:secadmin pueden modificar una política de enmascaramiento.
## Sintaxis
```
ALTER MASKING POLICY
{ policy_name | database_name.policy_name }
USING (masking_expression);
```
## Parameters
*policy\$1name*
Nombre de la política de enmascaramiento. Debe ser el nombre de una política de enmascaramiento que ya exista en la base de datos.
database\$1name
El nombre de la base de datos a partir de la que se crea la política. La base de datos puede ser la base de datos conectada o una base de datos que admita los permisos federados de Amazon Redshift.
*masking\$1expression*
Expresión SQL que se utiliza para transformar las columnas de destino. Se puede escribir mediante funciones de manipulación de datos, como las funciones de manipulación de cadenas, o junto con funciones definidas por el usuario escritas en SQL, Python o con AWS Lambda.
La expresión debe coincidir con las columnas de entrada y los tipos de datos de la expresión original. Por ejemplo, si las columnas de entrada de la política de enmascaramiento original fueran `sample_1 FLOAT` y`sample_2 VARCHAR(10)`, no podría modificar la política de enmascaramiento para que ocupara una tercera columna ni hacer que la política aceptara un valor FLOAT y un valor BOOLEAN. Si usa una constante como expresión de enmascaramiento, debe convertirla explícitamente a un tipo que coincida con el tipo de entrada.
Debe tener el permiso USAGE en todas las funciones definidas por el usuario que utilice en la expresión de enmascaramiento.
Para obtener información sobre el uso de ALTER MASKING POLICY en el catálogo de permisos federados de Amazon Redshift, consulte [Administración del control de acceso en el catálogo de permisos federados de Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/dg/federated-permissions-managing-access.html).
# ALTER MATERIALIZED VIEW
Cambia los atributos de una vista materializada.
## Sintaxis
```
ALTER MATERIALIZED VIEW mv_name
{
AUTO REFRESH { YES | NO }
| ALTER DISTKEY column_name
| ALTER DISTSTYLE ALL
| ALTER DISTSTYLE EVEN
| ALTER DISTSTYLE KEY DISTKEY column_name
| ALTER DISTSTYLE AUTO
| ALTER [COMPOUND] SORTKEY ( column_name [,...] )
| ALTER SORTKEY AUTO
| ALTER SORTKEY NONE
| ROW LEVEL SECURITY { ON | OFF } [ CONJUNCTION TYPE { AND | OR } ] [FOR DATASHARES]
};
```
## Parameters
*mv\$1name*
Se trata del nombre de la vista materializada que se modificará.
AUTO REFRESH \$1 YES \$1 NO \$1
Una cláusula que activa o desactiva la actualización automática de una vista materializada. Para obtener más información acerca de la actualización automática de vistas materializadas, consulte [Actualización de una vista materializada](materialized-view-refresh.md).
ALTER DISTSTYLE ALL
Cláusula que cambia el estilo de distribución existente de una relación con `ALL`. Considere lo siguiente:
+ Las operaciones ALTER DISTSTYTLE, ALTER SORTKEY y VACUUM no pueden ejecutarse simultáneamente en la misma relación.
+ Si se está ejecutando la operación VACUUM actualmente, la ejecución de ALTER DISTSTYLE ALL devuelve un error.
+ Si se está ejecutando ALTER DISTSTYLE ALL, no se iniciará una limpieza en segundo plano en una relación.
+ El comando ALTER DISTSTYLE ALL no está admitido en relaciones con claves de clasificación intercaladas y tablas temporales.
+ Si el estilo de distribución se definió previamente como AUTO, la relación ya no será candidata para la optimización automática de tablas.
Para obtener más información acerca de DISTSTYLE ALL, vaya a [CREATE MATERIALIZED VIEW](materialized-view-create-sql-command.md).
ALTER DISTSTYLE EVEN
Cláusula que cambia el estilo de distribución existente de una relación con `EVEN`. Considere lo siguiente:
+ Las operaciones ALTER DISTSYTLE, ALTER SORTKEY y VACUUM no pueden ejecutarse simultáneamente en la misma relación.
+ Si se está ejecutando VACUUM actualmente, la ejecución de ALTER DISTSTYLE EVEN devuelve un error.
+ Si se está ejecutando ALTER DISTSTYLE EVEN, no se iniciará una limpieza en segundo plano en una relación.
+ El comando ALTER DISTSTYLE EVEN no está admitido en relaciones con claves de clasificación intercaladas y tablas temporales.
+ Si el estilo de distribución se definió previamente como AUTO, la relación ya no será candidata para la optimización automática de tablas.
Para obtener más información acerca de DISTSTYLE EVEN, consulte [CREATE MATERIALIZED VIEW](materialized-view-create-sql-command.md).
ALTER DISTKEY *column\$1name* o ALTER DISTSTYLE KEY DISTKEY *column\$1name*
Cláusula que cambia la columna usada como la clave de distribución de una relación. Considere lo siguiente:
+ Las operaciones VACUUM y ALTER DISTKEY no se pueden ejecutar simultáneamente en la misma relación.
+ Si ya se está ejecutando VACUUM, ALTER DISTKEY devolverá un error.
+ Si se está ejecutando ALTER DISTKEY, la limpieza en segundo plano no se iniciará en una relación.
+ Si se está ejecutando ALTER DISTKEY, la limpieza en primer plano devolverá un error.
+ Solo puede ejecutar un comando ALTER DISTKEY en una relación a la vez.
+ El comando ALTER DISTKEY no es compatible en relaciones con claves de clasificación intercalada.
+ Si el estilo de distribución se definió previamente como AUTO, la relación ya no será candidata para la optimización automática de tablas.
Al especificar DISTSTYLE KEY, los datos se distribuyen por los valores en la columna DISTKEY. Para obtener más información acerca de DISTSTYLE, consulte [CREATE MATERIALIZED VIEW](materialized-view-create-sql-command.md).
ALTER DISTSTYLE AUTO
Cláusula que cambia el estilo de distribución existente de una relación a AUTO.
Si modifica un estilo de distribución a AUTO, el estilo de distribución de la tabla se establece de la siguiente manera:
+ Una relación pequeña con DISTSTYLE ALL se convierte a AUTO(ALL).
+ Una relación pequeña con DISTSTYLE EVEN se convierte a AUTO(ALL).
+ Una relación pequeña con DISTSTYLE KEY se convierte a AUTO(ALL).
+ Una relación grande con DISTSTYLE ALL se convierte a AUTO(EVEN).
+ Una relación grande con DISTSTYLE EVEN se convierte a AUTO(EVEN).
+ Una relación grande con DISTSTYLE KEY se convierte a AUTO(KEY) y se conserva DISTKEY. En este caso, Amazon Redshift no cambia la relación.
Si Amazon Redshift determina que un estilo de distribución nuevo o una clave nueva mejorarán el rendimiento de las consultas, Amazon Redshift podría cambiar el estilo de distribución o la clave de la relación en el futuro. Por ejemplo, Amazon Redshift podría convertir una relación con un valor de DISTSTYLE de AUTO(KEY) en AUTO(EVEN) o viceversa. Para obtener más información sobre el comportamiento cuando se modifican las claves de distribución, incluida la redistribución de datos y los bloqueos, consulte [Recomendaciones de Amazon Redshift Advisor](https://docs.aws.amazon.com/redshift/latest/dg/advisor-recommendations.html#alter-diststyle-distkey-recommendation).
Para obtener más información acerca de DISTSTYLE AUTO, consulte [CREATE MATERIALIZED VIEW](materialized-view-create-sql-command.md).
Para ver el estilo de distribución de una relación, consulte la vista de catálogo del sistema SVV\$1TABLE\$1INFO. Para obtener más información, consulte [SVV\$1TABLE\$1INFO](r_SVV_TABLE_INFO.md). Si desea ver las recomendaciones para relaciones de Advisor de Amazon Redshift, consulte la vista de catálogo del sistema SVV\$1ALTER\$1TABLE\$1RECOMMENDATIONS. Para obtener más información, consulte [SVV\$1ALTER\$1TABLE\$1RECOMMENDATIONS](r_SVV_ALTER_TABLE_RECOMMENDATIONS.md). Para ver las acciones llevadas a cabo por Amazon Redshift, consulte la vista de catálogo del sistema SVL\$1AUTO\$1WORKER\$1ACTION. Para obtener más información, consulte [SVL\$1AUTO\$1WORKER\$1ACTION](r_SVL_AUTO_WORKER_ACTION.md).
ALTER [COMPOUND] SORTKEY ( *column\$1name* [,...] )
Una cláusula que cambia o añade la clave de clasificación utilizada para una relación. ALTER SORTKEY no se admite en tablas temporales.
Cuando se modifica una clave de ordenación, la codificación de compresión de las columnas de la clave de ordenación nueva u original puede cambiar. Si no se define de forma explícita ninguna codificación para la relación, entonces Amazon Redshift asigna automáticamente las codificaciones de compresión de la siguiente manera:
+ A las columnas que están definidas como claves de ordenación se les asigna una compresión RAW.
+ A las columnas que están definidas como tipos de datos BOOLEAN, REAL o DOUBLE PRECISION se les asigna una compresión RAW.
+ A las columnas que se definen como SMALLINT, INTEGER, BIGINT, DECIMAL, DATE, TIME, TIMETZ, TIMESTAMP o TIMESTAMPTZ se les asigna la compresión AZ64.
+ Las columnas que se definen como CHAR o VARCHAR tienen asignada la compresión LZO.
Considere lo siguiente:
+ Puede definir un máximo de 400 columnas para una clave de clasificación para cada relación.
+ Puede alterar una clave de ordenación intercalada por una clave de ordenación compuesta o por ninguna clave de ordenación. No obstante, no puede alterar una clave de ordenación compuesta por una clave de ordenación intercalada.
+ Si la clave de clasificación se definió previamente como AUTO, la relación ya no será candidata para la optimización automática de tablas.
+ Amazon Redshift recomienda utilizar la codificación RAW (sin compresión) para columnas definidas como claves de ordenación. Cuando se modifica una columna para elegirla como clave de ordenación, la compresión de la columna se cambia a la compresión RAW (sin compresión). Esto puede aumentar la cantidad de almacenamiento que requiere la relación. El aumento del tamaño de la relación depende de la definición específica de la relación y de su contenido. Para obtener más información acerca de la compresión, consulte [Codificaciones de compresión](c_Compression_encodings.md).
Cuando se cargan datos en una relación, se hace en el orden definido por la clave de clasificación. Cuando se modifica la clave de ordenación, Amazon Redshift reordena los datos. Para obtener más información acerca de SORTKEY, consulte [CREATE MATERIALIZED VIEW](materialized-view-create-sql-command.md).
ALTER SORTKEY AUTO
Se trata de una cláusula que modifica la clave de clasificación de la relación de destino a AUTO o la añade. ALTER SORTKEY AUTO no se admite en tablas temporales.
Cuando se modifica una clave de clasificación a AUTO, Amazon Redshift conserva la clave de ordenación existente de la relación.
Si Amazon Redshift determina que una clave de clasificación nueva mejorará el rendimiento de las consultas, Amazon Redshift podría cambiar la clave de clasificación de la relación en el futuro.
Para obtener más información acerca de SORTKEY AUTO, consulte [CREATE MATERIALIZED VIEW](materialized-view-create-sql-command.md).
Para ver la clave de clasificación de una relación, consulte la vista de catálogo del sistema SVV\$1TABLE\$1INFO. Para obtener más información, consulte [SVV\$1TABLE\$1INFO](r_SVV_TABLE_INFO.md). Si desea ver las recomendaciones para relaciones de Advisor de Amazon Redshift, consulte la vista de catálogo del sistema SVV\$1ALTER\$1TABLE\$1RECOMMENDATIONS. Para obtener más información, consulte [SVV\$1ALTER\$1TABLE\$1RECOMMENDATIONS](r_SVV_ALTER_TABLE_RECOMMENDATIONS.md). Para ver las acciones llevadas a cabo por Amazon Redshift, consulte la vista de catálogo del sistema SVL\$1AUTO\$1WORKER\$1ACTION. Para obtener más información, consulte [SVL\$1AUTO\$1WORKER\$1ACTION](r_SVL_AUTO_WORKER_ACTION.md).
ALTER SORTKEY NONE
Se trata de una cláusula que quita la clave de clasificación de la relación de destino.
Si la clave de clasificación se definió previamente como AUTO, la relación ya no será candidata para la optimización automática de tablas.
ROW LEVEL SECURITY \$1 ON \$1 OFF \$1 [ CONJUNCTION TYPE \$1 AND \$1 OR \$1 ] [ FOR DATASHARES ]
Es una cláusula que activa o desactiva la seguridad de nivel de fila para una relación.
Cuando la seguridad de nivel de fila está activada para una relación, solo puede leer las filas a las que la política de seguridad de nivel de fila le permite acceder. Si no hay ninguna política que le conceda acceso a la relación, no podrá ver ninguna fila de la relación. Solo los superusuarios y los usuarios o roles que tienen el rol `sys:secadmin` pueden establecer la cláusula ROW LEVEL SECURITY. Para obtener más información, consulte [Seguridad de nivel básico](t_rls.md).
+ [ CONJUNCTION TYPE \$1 AND \$1 OR \$1 ]
Es una cláusula que le permite elegir el tipo de conjunción de la política de seguridad a nivel de fila para una relación. Si se asocian varias políticas de seguridad en el nivel de fila a una relación, puede combinarlas con la cláusula AND u OR. De forma predeterminada, Amazon Redshift combina las políticas de RLS con la cláusula AND. Los superusuarios, usuarios o roles que tienen el rol `sys:secadmin` pueden usar esta cláusula para definir el tipo de conjunción de la política de seguridad de nivel de fila para una relación. Para obtener más información, consulte [Combinación de varias políticas por usuario](t_rls_combine_policies.md).
+ PARA RECURSOS COMPARTIDOS DE DATOS
Es una cláusula que determina si se puede acceder a una relación protegida por RLS a través de recursos compartidos de datos. De forma predeterminada, no se puede acceder a una relación protegida por RLS a través de un recurso compartido de datos. Un comando ALTER MATERIALIZED VIEW ROW LEVEL SECURITY ejecutado con esta cláusula solo afecta a la propiedad de accesibilidad de recurso compartido de datos de la relación. La propiedad ROW LEVEL SECURITY no ha cambiado.
Si hace que una relación protegida por RLS sea accesible a través de recursos compartidos de datos, la relación no tendrá seguridad de nivel de fila en la base de datos de recurso compartido de datos del lado del consumidor. La relación conserva su propiedad RLS del lado del productor.
## Ejemplos
En el siguiente ejemplo, se habilita la actualización automática de la vista materializada `tickets_mv`.
```
ALTER MATERIALIZED VIEW tickets_mv AUTO REFRESH YES
```
# Ejemplos de DISTSTYLE y SORTKEY para ALTER MATERIALIZED VIEW
En los ejemplos de este tema se muestra cómo realizar cambios en DISTSTYLE y SORTKEY mediante ALTER MATERIALIZED VIEW.
Las consultas de ejemplo siguientes muestran cómo modificar una columna DISTSTYLE KEY DISTKEY mediante una tabla base de ejemplo:
```
CREATE TABLE base_inventory(
inv_date_sk int4 NOT NULL,
inv_item_sk int4 NOT NULL,
inv_warehouse_sk int4 NOT NULL,
inv_quantity_on_hand int4
);
INSERT INTO base_inventory VALUES(1,1,1,1);
CREATE materialized VIEW inventory diststyle even AS SELECT * FROM base_inventory;
SELECT "table", diststyle FROM svv_table_info WHERE "table" = 'inventory';
ALTER materialized VIEW inventory ALTER diststyle KEY distkey inv_warehouse_sk;
SELECT "table", diststyle FROM svv_table_info WHERE "table" = 'inventory';
ALTER materialized VIEW inventory ALTER distkey inv_item_sk;
SELECT "table", diststyle FROM svv_table_info WHERE "table" = 'inventory';
DROP TABLE base_inventory CASCADE;
```
Modifique una vista materializada a DISTSTYLE ALL:
```
CREATE TABLE base_inventory(
inv_date_sk int4 NOT NULL,
inv_item_sk int4 NOT NULL,
inv_warehouse_sk int4 NOT NULL,
inv_quantity_on_hand int4
);
INSERT INTO base_inventory VALUES(1,1,1,1);
CREATE materialized VIEW inventory diststyle even AS SELECT * FROM base_inventory;
SELECT "table", diststyle FROM svv_table_info WHERE "table" = 'inventory';
ALTER MATERIALIZED VIEW inventory ALTER diststyle ALL;
SELECT "table", diststyle FROM svv_table_info WHERE "table" = 'inventory';
DROP TABLE base_inventory CASCADE;
```
Los siguientes comandos muestran ejemplos de ALTER MATERIALIZED VIEW SORTKEY, con una tabla base de ejemplo:
```
CREATE TABLE base_inventory (c0 int, c1 int);
INSERT INTO base_inventory VALUES(1,1);
CREATE materialized VIEW inventory interleaved sortkey(c0, c1) AS SELECT * FROM base_inventory;
SELECT "table", sortkey1 FROM svv_table_info WHERE "table" = 'inventory';
ALTER materialized VIEW inventory ALTER sortkey(c0, c1);
SELECT "table", diststyle, sortkey_num FROM svv_table_info WHERE "table" = 'inventory';
ALTER materialized VIEW inventory ALTER sortkey NONE;
SELECT "table", diststyle, sortkey_num FROM svv_table_info WHERE "table" = 'inventory';
ALTER materialized VIEW inventory ALTER sortkey(c0);
SELECT "table", diststyle, sortkey_num FROM svv_table_info WHERE "table" = 'inventory';
DROP TABLE base_inventory CASCADE;
```
# ALTER RLS POLICY
Modifique una política de seguridad de nivel de fila existente en una tabla.
Los superusuarios y los usuarios o roles que tienen el rol `sys:secadmin` pueden modificar una política.
## Sintaxis
```
ALTER RLS POLICY
{ policy_name | database_name.policy_name }
USING ( using_predicate_exp );
```
## Parameters
*policy\$1name*
El nombre de la política.
database\$1name
El nombre de la base de datos a partir de la que se crea la política. La base de datos puede ser la base de datos conectada o una base de datos que admita los permisos federados de Amazon Redshift.
USING (* using\$1predicate\$1exp *)
Especifica un filtro que se aplica a la cláusula WHERE de la consulta. Amazon Redshift aplica un predicado de política antes de los predicados de usuario de la consulta. Por ejemplo, **current\$1user = ‘joe’ and price > 10** limita a Joe a ver solo registros con un precio superior a 10 USD.
La expresión tiene acceso a las variables declaradas en la cláusula WITH de la instrucción CREATE RLS POLICY que se utilizó para crear la política con el nombre policy\$1name.
Para obtener información sobre el uso de ALTER RLS POLICY en el catálogo de permisos federados de Amazon Redshift, consulte [Administración del control de acceso en el catálogo de permisos federados de Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/dg/federated-permissions-managing-access.html).
## Ejemplos
En el siguiente ejemplo se modifica una política de RLS.
```
-- First create an RLS policy that limits access to rows where catgroup is 'concerts'.
CREATE RLS POLICY policy_concerts
WITH (catgroup VARCHAR(10))
USING (catgroup = 'concerts');
-- Then, alter the RLS policy to only show rows where catgroup is 'piano concerts'.
ALTER RLS POLICY policy_concerts
USING (catgroup = 'piano concerts');
```
# ALTER ROLE
Cambia el nombre de un rol o cambia el propietario. Para obtener una lista de roles definidos por el sistema de Amazon Redshift, consulte [Roles definidos por el sistema de Amazon Redshift](r_roles-default.md).
## Permisos necesarios
Los siguientes permisos son necesarios para ALTER ROLE:
+ Superusuario
+ Usuarios con los permisos ALTER ROLE
## Sintaxis
```
ALTER ROLE role [ WITH ]
{ { RENAME TO role } | { OWNER TO user_name } }[, ...]
[ EXTERNALID TO external_id ]
```
## Parameters
*Rol*
Nombre del rol que se debe modificar.
RENAME TO
Nuevo nombre del rol.
OWNER TO *user\$1name*
Nuevo propietario del rol.
EXTERNALID TO *external\$1id*
Un nuevo ID externo para el rol, que está asociado con un proveedor de identidades. Para obtener más información, consulte [Federación de proveedores de identidades nativos (IdP) para Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-native-idp.html).
## Ejemplos
El siguiente ejemplo cambia el nombre de un rol de `sample_role1` a `sample_role2`.
```
ALTER ROLE sample_role1 RENAME TO sample_role2;
```
El siguiente ejemplo cambia el propietario del rol.
```
ALTER ROLE sample_role1 WITH OWNER TO user1
```
La sintaxis de ALTER ROLE es similar a la de ALTER PROCEDURE, que aparece a continuación.
```
ALTER PROCEDURE first_quarter_revenue(bigint, numeric) RENAME TO quarterly_revenue;
```
En el siguiente ejemplo, se modifica el propietario de un procedimiento a `etl_user`.
```
ALTER PROCEDURE quarterly_revenue(bigint, numeric) OWNER TO etl_user;
```
En el ejemplo siguiente se actualiza un rol `sample_role1` con un nuevo ID externo asociado a un proveedor de identidades.
```
ALTER ROLE sample_role1 EXTERNALID TO "XYZ456";
```
# ALTER PROCEDURE
Cambia el nombre de un procedimiento o cambia el propietario. Se necesitan ambos, el nombre del procedimiento y los tipos de datos, o la firma. Solo el propietario o un superusuario pueden cambiar el nombre de un procedimiento. Solo un superusuario puede cambiar el propietario de un procedimiento.
## Sintaxis
```
ALTER PROCEDURE sp_name [ ( [ [ argname ] [ argmode ] argtype [, ...] ] ) ]
RENAME TO new_name
```
```
ALTER PROCEDURE sp_name [ ( [ [ argname ] [ argmode ] argtype [, ...] ] ) ]
OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
```
## Parameters
*sp\$1name*
El nombre del procedimiento que debe modificarse. Especifique solo el nombre del procedimiento en la ruta de búsqueda actual o utilice el formato `schema_name.sp_procedure_name` para usar un esquema específico.
*[argname] [argmode] argtype*
Una lista de nombres de argumento, modos de argumento y tipos de datos. Solo se requieren los tipos de datos de entrada, que se utilizan para identificar el procedimiento almacenado. Además, puede proporcionar la firma completa utilizada para crear el procedimiento incluidos los parámetros de entrada y salida con sus modos.
*new\$1name*
Un nombre nuevo para el procedimiento almacenado.
*new\$1owner* \$1 CURRENT\$1USER \$1 SESSION\$1USER
Un usuario nuevo para el procedimiento almacenado.
## Ejemplos
En el siguiente ejemplo, se cambia el nombre de un procedimiento de `first_quarter_revenue` a `quarterly_revenue`.
```
ALTER PROCEDURE first_quarter_revenue(volume INOUT bigint, at_price IN numeric,
result OUT int) RENAME TO quarterly_revenue;
```
Este ejemplo equivale a lo siguiente.
```
ALTER PROCEDURE first_quarter_revenue(bigint, numeric) RENAME TO quarterly_revenue;
```
En el siguiente ejemplo, se modifica el propietario de un procedimiento a `etl_user`.
```
ALTER PROCEDURE quarterly_revenue(bigint, numeric) OWNER TO etl_user;
```
# ALTER SCHEMA
Cambia la definición de un esquema existente. Utilice este comando para cambiar el nombre de un esquema o el propietario de un esquema. Por ejemplo, cambie el nombre de un esquema existente para conservar una copia de seguridad de ese esquema cuando planifique crear una nueva versión de ese esquema. Para obtener más información acerca de los esquemas, consulte [CREATE SCHEMA](r_CREATE_SCHEMA.md).
Para ver las cuotas del esquema configuradas, consulte [SVV\$1SCHEMA\$1QUOTA\$1STATE](r_SVV_SCHEMA_QUOTA_STATE.md).
Para ver los registros en los que se superaron las cuotas del esquema, consulte [STL\$1SCHEMA\$1QUOTA\$1VIOLATIONS](r_STL_SCHEMA_QUOTA_VIOLATIONS.md).
## Privilegios necesarios
Los siguientes privilegios son necesarios para ALTER SCHEMA:
+ Superusuario
+ Usuarios con el privilegio ALTER SCHEMA
+ Propietario del esquema
Al cambiar el nombre de un esquema, tenga en cuenta que los objetos que utilizan el nombre anterior, como los procedimientos almacenados o las vistas materializadas, deben actualizarse para utilizar el nuevo nombre.
## Sintaxis
```
ALTER SCHEMA schema_name
{
RENAME TO new_name |
OWNER TO new_owner |
QUOTA { quota [MB | GB | TB] | UNLIMITED }
}
```
## Parameters
*schema\$1name*
El nombre del esquema de la base de datos que se modificará.
RENAME TO
Una cláusula que cambia el nombre del esquema.
*new\$1name*
El nuevo nombre del esquema. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
OWNER TO
Una cláusula que cambia el propietario del esquema.
*new\$1owner*
El nuevo propietario del esquema.
QUOTA
La cantidad máxima de espacio en disco que puede utilizar el esquema especificado. Este espacio es el tamaño colectivo de todas las tablas en el esquema especificado. Amazon Redshift convierte el valor seleccionado en megabytes. Gigabytes es la unidad de medida predeterminada cuando no se especifica un valor.
Para obtener más información acerca de la configuración de las cuotas del esquema, consulte [CREATE SCHEMA](r_CREATE_SCHEMA.md).
## Ejemplos
En el siguiente ejemplo, se cambia el nombre del esquema SALES a US\$1SALES.
```
alter schema sales
rename to us_sales;
```
En el siguiente ejemplo, se otorga la propiedad del esquema US\$1SALES al usuario DWUSER.
```
alter schema us_sales
owner to dwuser;
```
En el siguiente ejemplo, se cambia la cuota a 300 MB y se quita la cuota.
```
alter schema us_sales QUOTA 300 GB;
alter schema us_sales QUOTA UNLIMITED;
```
# ALTER SYSTEM
Cambia una opción de configuración en el sistema para el clúster de Amazon Redshift o el grupo de trabajo de Amazon Redshift sin servidor.
## Privilegios necesarios
Uno de los siguientes tipos de usuario puede ejecutar el comando ALTER SYSTEM:
+ Superusuario
+ Usuario administrador
## Sintaxis
```
ALTER SYSTEM SET system-level-configuration = {true| t | on | false | f | off}
```
## Parameters
*system-level-configuration*
Configuración en el nivel del sistema. Valores válidos: `data_catalog_auto_mount` y `metadata_security`.
\$1true\$1 t \$1 on \$1 false \$1 f \$1 off\$1
Un valor para activar o desactivar la configuración en el nivel de sistema. Un valor `true`, `t` o `on` indica que se active la configuración. Un valor `false`, `f` o `off` indica que se desactive la configuración.
## Notas de uso
Para un clúster aprovisionado, los cambios en `data_catalog_auto_mount` entran en vigor en el siguiente reinicio del clúster. Para obtener más información, consulte [Reinicio de un clúster](https://docs.aws.amazon.com/redshift/latest/mgmt/managing-clusters-console.html#reboot-cluster) en la *Guía de administración de Amazon Redshift*.
En el caso de un grupo de trabajo sin servidor, los cambios en `data_catalog_auto_mount` no se aplican de forma inmediata.
## Ejemplos
En el ejemplo siguiente se activa el montaje automático de AWS Glue Data Catalog.
```
ALTER SYSTEM SET data_catalog_auto_mount = true;
```
En el ejemplo siguiente se activa la seguridad de los metadatos.
```
ALTER SYSTEM SET metadata_security = true;
```
### Establecimiento de un espacio de nombres de identidad predeterminado
Este ejemplo es específico para trabajar con un proveedor de identidades. Puede integrar Redshift con IAM Identity Center y un proveedor de identidades para centralizar la administración de identidades para Redshift y otros servicios de AWS.
El siguiente ejemplo muestra cómo configurar el espacio de nombres de identidades predeterminado para el sistema. Si lo hace posteriormente, resultará más sencillo ejecutar las instrucciones GRANT y CREATE, ya que no es necesario incluir el espacio de nombres como prefijo para cada identidad.
```
ALTER SYSTEM SET default_identity_namespace = 'MYCO';
```
Tras ejecutar el comando, puede ejecutar instrucciones como las siguientes:
```
GRANT SELECT ON TABLE mytable TO alice;
GRANT UPDATE ON TABLE mytable TO salesrole;
CREATE USER bob password 'md50c983d1a624280812631c5389e60d48c';
```
El efecto de establecer el espacio de nombres de identidades predeterminado es que cada identidad no lo requiere como prefijo. En este ejemplo, `alice` se sustituye por `MYCO:alice`. Esto ocurre con cualquier identidad incluida. Para obtener más información sobre cómo usar un proveedor de identidades con Redshift, consulte [Conectar Redshift con IAM Identity Center para ofrecer a los usuarios una experiencia de inicio de sesión único](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-idp-connect.html).
Para obtener más información acerca de los ajustes relacionados con la configuración de Redshift con IAM Identity Center, consulte [SET](r_SET.md) y [MODIFICAR PROVEEDOR DE IDENTIDADES](r_ALTER_IDENTITY_PROVIDER.md).
# ALTER TABLE
Este comando cambia la definición de una tabla de Amazon Redshift o de una tabla externa de Amazon Redshift Spectrum. Este comando actualiza los valores y las propiedades establecidos por [CREATE TABLE](r_CREATE_TABLE_NEW.md) o [CREATE EXTERNAL TABLE](r_CREATE_EXTERNAL_TABLE.md). Puede utilizar ALTER TABLE en una vista para la seguridad a nivel de fila (RLS).
No puede ejecutar ALTER TABLE en una tabla externa dentro de un bloque de transacción (BEGIN … END). Para obtener más información acerca de las transacciones, consulte [Niveles de aislamiento en Amazon Redshift](c_serial_isolation.md).
ALTER TABLE bloquea la tabla para operaciones de lectura y escritura hasta que se complete la transacción que incluye la operación ALTER TABLE, a menos que en la documentación se indique específicamente que se pueden realizar consultas de datos u otras operaciones en la tabla mientras se la modifica.
## Privilegios necesarios
El usuario que modifica una tabla necesita el privilegio adecuado para que el comando se ejecute correctamente. Según el comando ALTER TABLE, se requiere uno de los siguientes privilegios.
+ Superusuario
+ Usuarios con el privilegio ALTER TABLE
+ Propietario de la tabla con el privilegio USAGE en el esquema
## Sintaxis
```
ALTER TABLE table_name
{
ADD table_constraint
| DROP CONSTRAINT constraint_name [ RESTRICT | CASCADE ]
| OWNER TO new_owner
| RENAME TO new_name
| RENAME COLUMN column_name TO new_name
| ALTER COLUMN column_name TYPE updated_varchar_data_type_size
| ALTER COLUMN column_name ENCODE new_encode_type
| ALTER COLUMN column_name ENCODE encode_type,
| ALTER COLUMN column_name ENCODE encode_type, .....;
| ALTER DISTKEY column_name
| ALTER DISTSTYLE ALL
| ALTER DISTSTYLE EVEN
| ALTER DISTSTYLE KEY DISTKEY column_name
| ALTER DISTSTYLE AUTO
| ALTER [COMPOUND] SORTKEY ( column_name [,...] )
| ALTER SORTKEY AUTO
| ALTER SORTKEY NONE
| ALTER ENCODE AUTO
| ADD [ COLUMN ] column_name column_type
[ DEFAULT default_expr ]
[ ENCODE encoding ]
[ NOT NULL | NULL ]
[ COLLATE { CASE_SENSITIVE | CS | CASE_INSENSITIVE | CI } ] |
| DROP [ COLUMN ] column_name [ RESTRICT | CASCADE ]
| ROW LEVEL SECURITY { ON | OFF } [ CONJUNCTION TYPE { AND | OR } ] [ FOR DATASHARES ]
| MASKING { ON | OFF } FOR DATASHARES }
where table_constraint is:
[ CONSTRAINT constraint_name ]
{ UNIQUE ( column_name [, ... ] )
| PRIMARY KEY ( column_name [, ... ] )
| FOREIGN KEY (column_name [, ... ] )
REFERENCES reftable [ ( refcolumn ) ]}
The following options apply only to external tables:
SET LOCATION { 's3://bucket/folder/' | 's3://bucket/manifest_file' }
| SET FILE FORMAT format |
| SET TABLE PROPERTIES ('property_name'='property_value')
| PARTITION ( partition_column=partition_value [, ...] )
SET LOCATION { 's3://bucket/folder' |'s3://bucket/manifest_file' }
| ADD [IF NOT EXISTS]
PARTITION ( partition_column=partition_value [, ...] ) LOCATION { 's3://bucket/folder' |'s3://bucket/manifest_file' }
[, ... ]
| DROP PARTITION ( partition_column=partition_value [, ...] )
```
Para reducir el tiempo de ejecución del comando ALTER TABLE, puede combinar algunas cláusulas del comando ALTER TABLE.
Amazon Redshift admite las siguientes combinaciones de las cláusulas ALTER TABLE:
```
ALTER TABLE tablename ALTER SORTKEY (column_list), ALTER DISTKEY column_Id;
ALTER TABLE tablename ALTER DISTKEY column_Id, ALTER SORTKEY (column_list);
ALTER TABLE tablename ALTER SORTKEY (column_list), ALTER DISTSTYLE ALL;
ALTER TABLE tablename ALTER DISTSTYLE ALL, ALTER SORTKEY (column_list);
```
## Parameters
*table\$1name*
El nombre de la tabla que se modificará. Especifique solo el nombre de la tabla o use el formato *nombre\$1de\$1esquema.nombre\$1de\$1tabla* para usar un esquema específico. Las tablas externas deben estar clasificadas por el nombre de un esquema externo. También puede especificar un nombre de vista si está utilizando la instrucción ALTER TABLE para cambiar el nombre de una vista o cambiar su propietario. La longitud máxima del nombre de la tabla es de 127 bytes; los nombres más largos se truncan en 127 bytes. Puede usar caracteres multibyte UTF-8 de hasta un máximo de cuatro bytes. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
ADD *table\$1constraint*
Una cláusula que agrega la restricción especificada a la tabla. Para obtener descripciones de los valores *table\$1constraint* válidos, consulte [CREATE TABLE](r_CREATE_TABLE_NEW.md).
No se puede agregar una restricción de clave principal a una columna que se puede anular. Si la columna se creó originalmente con la restricción NOT NULL, puede agregar la restricción de clave principal.
DROP CONSTRAINT *constraint\$1name*
Una cláusula que elimina la restricción mencionada de la tabla. Para eliminar una restricción, especifique el nombre de la restricción, no el tipo de restricción. Para ver los nombres de restricciones de la tabla, ejecute la siguiente consulta.
```
select constraint_name, constraint_type
from information_schema.table_constraints;
```
RESTRICT
Una cláusula que elimina solo la restricción especificada. RESTRICT es una opción para DROP CONSTRAINT. RESTRICT no puede utilizarse con CASCADE.
CASCADE
Una cláusula que elimina la restricción especificada y todos los elementos que dependen de esa restricción. CASCADE es una opción para DROP CONSTRAINT. CASCADE no puede utilizarse con RESTRICT.
OWNER TO *new\$1owner*
Cláusula que cambia el propietario de la tabla (o la vista) al valor *new\$1owner*.
RENAME TO *new\$1name*
Cláusula que cambia el nombre de una tabla (o una vista) al valor especificado en *new\$1name*. La longitud máxima del nombre de la tabla es de 127 bytes; los nombres más largos se truncan en 127 bytes.
No se puede cambiar el nombre de una tabla permanente a un nombre que comienza por "\$1". El nombre de una tabla que comienza con "\$1" indica una tabla temporal.
No se puede cambiar el nombre de una tabla externa.
ALTER COLUMN *nombre\$1de\$1columna* TYPE *tamaño\$1de\$1tipo\$1de\$1datos\$1varchar\$1actualizado*
Una cláusula que cambia el tamaño de una columna definida como un tipo de datos VARCHAR. Esta cláusula solo admite la modificación del tamaño de un tipo de datos VARCHAR. Tenga en cuenta las siguientes restricciones:
+ No puede modificar una columna con codificaciones de compresión BYTEDICT, RUNLENGTH, TEXT255 o TEXT32K.
+ No puede disminuir el tamaño por debajo del tamaño máximo de los datos existentes.
+ No puede modificar columnas con valores predeterminados.
+ No puede modificar columnas con UNIQUE, PRIMARY KEY o FOREIGN KEY.
+ No puede modificar las columnas dentro de un bloque de transacción (BEGIN … END) Para obtener más información acerca de las transacciones, consulte [Niveles de aislamiento en Amazon Redshift](c_serial_isolation.md).
ALTER COLUMN *column\$1name* ENCODE *new\$1encode\$1type*
Se trata de una cláusula que cambia la codificación de compresión de una columna. Si especifica la codificación de compresión para una columna, la tabla ya no se establece en ENCODE AUTO. Para obtener información acerca de la codificación de compresión, consulte [Compresión de columnas para reducir el tamaño de los datos almacenados](t_Compressing_data_on_disk.md).
Cuando se cambia la codificación de compresión de una columna, la tabla sigue disponible para realizar consultas.
Tenga en cuenta las siguientes restricciones:
+ No puede modificar una columna para que tenga la misma codificación que la definida actualmente.
+ No puede modificar la codificación de una columna en una tabla con una clave de ordenación intercalada.
ALTER COLUMN *column\$1name* ENCODE *encode\$1type*, ALTER COLUMN *column\$1name* ENCODE *encode\$1type*, .....;
Se trata de una cláusula que modifica la codificación de compresión de varias columnas en un solo comando. Para obtener información acerca de la codificación de compresión, consulte [Compresión de columnas para reducir el tamaño de los datos almacenados](t_Compressing_data_on_disk.md).
Cuando se cambia la codificación de compresión de una columna, la tabla sigue disponible para realizar consultas.
Tenga en cuenta las siguientes restricciones:
+ No puede modificar una columna con el mismo tipo de codificación o uno diferente varias veces con un solo comando.
+ No puede modificar una columna para que tenga la misma codificación que la definida actualmente.
+ No puede modificar la codificación de una columna en una tabla con una clave de ordenación intercalada.
ALTER DISTSTYLE ALL
Cláusula que cambia el estilo de distribución existente de una tabla a `ALL`. Considere lo siguiente:
+ Las operaciones ALTER DISTSTYTLE, ALTER SORTKEY y VACUUM no pueden ejecutarse simultáneamente en la misma tabla.
+ Si se está ejecutando la operación VACUUM actualmente, la ejecución de ALTER DISTSTYLE ALL devuelve un error.
+ Si se está ejecutando ALTER DISTSTYLE ALL, una limpieza en segundo plano no se iniciará en las tablas.
+ El comando ALTER DISTSTYLE ALL no está admitido en tablas con claves de ordenación intercaladas y tablas temporales.
+ Si el estilo de distribución se definió previamente como AUTO, la tabla ya no será candidata para la optimización automática de tablas.
Para obtener más información acerca de DISTSTYLE ALL, consulte [CREATE TABLE](r_CREATE_TABLE_NEW.md).
ALTER DISTSTYLE EVEN
Cláusula que cambia el estilo de distribución existente de una tabla a `EVEN`. Considere lo siguiente:
+ Las operaciones ALTER DISTSYTLE, ALTER SORTKEY y VACUUM no pueden ejecutarse simultáneamente en la misma tabla.
+ Si se está ejecutando VACUUM actualmente, la ejecución de ALTER DISTSTYLE EVEN devuelve un error.
+ Si se está ejecutando ALTER DISTSTYLE EVEN, una limpieza en segundo plano no se inicia en una tabla.
+ El comando ALTER DISTSTYLE EVEN no se admite en tablas con claves de ordenación intercaladas y tablas temporales.
+ Si el estilo de distribución se definió previamente como AUTO, la tabla ya no será candidata para la optimización automática de tablas.
Para obtener más información acerca de DISTSTYLE EVEN, consulte [CREATE TABLE](r_CREATE_TABLE_NEW.md).
ALTER DISTKEY *column\$1name* o ALTER DISTSTYLE KEY DISTKEY *column\$1name*
Una cláusula que cambia la columna usada como la clave de distribución de una tabla. Considere lo siguiente:
+ Las operaciones VACUUM y ALTER DISTKEY no se pueden ejecutar simultáneamente en la misma tabla.
+ Si ya se está ejecutando VACUUM, ALTER DISTKEY devolverá un error.
+ Si se está ejecutando ALTER DISTKEY, la limpieza en segundo plano no se iniciará en las tablas.
+ Si se está ejecutando ALTER DISTKEY, la limpieza en primer plano devolverá un error.
+ Solo puede ejecutar un comando ALTER DISTKEY en una tabla cada vez.
+ El comando ALTER DISTKEY no es compatible en tablas con claves de ordenación intercalada.
+ Si el estilo de distribución se definió previamente como AUTO, la tabla ya no será candidata para la optimización automática de tablas.
Al especificar DISTSTYLE KEY, los datos se distribuyen por los valores en la columna DISTKEY. Para obtener más información acerca de DISTSTYLE, consulte [CREATE TABLE](r_CREATE_TABLE_NEW.md).
ALTER DISTSTYLE AUTO
Se trata de una cláusula que cambia el estilo de distribución existente de una tabla a AUTO.
Si modifica un estilo de distribución a AUTO, el estilo de distribución de la tabla se establece en las siguientes opciones:
+ Una tabla pequeña con DISTSTYLE ALL se convierte a AUTO(ALL).
+ Una tabla pequeña con DISTSTYLE EVEN se convierte a AUTO(ALL).
+ Una tabla pequeña con DISTSTYLE KEY se convierte a AUTO(ALL).
+ Una tabla grande con DISTSTYLE ALL se convierte a AUTO(EVEN).
+ Una tabla grande con DISTSTYLE EVEN se convierte a AUTO(EVEN).
+ Una tabla grande con DISTSTYLE KEY se convierte a AUTO(KEY) y se conserva DISTKEY. En este caso, Amazon Redshift no cambia la tabla.
Si Amazon Redshift determina que un estilo de distribución nuevo o una clave nueva mejorarán el rendimiento de las consultas, Amazon Redshift podría cambiar el estilo de distribución o la clave de la tabla en el futuro. Por ejemplo, Amazon Redshift podría convertir una tabla con un valor de DISTSTYLE de AUTO(KEY) en AUTO(EVEN) o viceversa. Para obtener más información sobre el comportamiento cuando se modifican las claves de distribución, incluida la redistribución de datos y los bloqueos, consulte las [Recomendaciones de Amazon Redshift Advisor](https://docs.aws.amazon.com/redshift/latest/dg/advisor-recommendations.html#alter-diststyle-distkey-recommendation).
Para obtener más información acerca de DISTSTYLE AUTO, consulte [CREATE TABLE](r_CREATE_TABLE_NEW.md).
Para ver el estilo de distribución de una tabla, consulte la vista de catálogo del sistema SVV\$1TABLE\$1INFO. Para obtener más información, consulte [SVV\$1TABLE\$1INFO](r_SVV_TABLE_INFO.md). Si desea ver las recomendaciones para tablas de Advisor de Amazon Redshift, consulte la vista de catálogo del sistema SVV\$1ALTER\$1TABLE\$1RECOMMENDATIONS. Para obtener más información, consulte [SVV\$1ALTER\$1TABLE\$1RECOMMENDATIONS](r_SVV_ALTER_TABLE_RECOMMENDATIONS.md). Para ver las acciones llevadas a cabo por Amazon Redshift, consulte la vista de catálogo del sistema SVL\$1AUTO\$1WORKER\$1ACTION. Para obtener más información, consulte [SVL\$1AUTO\$1WORKER\$1ACTION](r_SVL_AUTO_WORKER_ACTION.md).
ALTER [COMPOUND] SORTKEY ( *column\$1name* [,...] )
Una cláusula que cambia o agrega la clave de ordenación utilizada para una tabla. ALTER SORTKEY no se admite en tablas temporales.
Cuando se modifica una clave de ordenación, la codificación de compresión de las columnas de la clave de ordenación nueva u original puede cambiar. Si no se define de forma explícita ninguna codificación para la tabla, entonces Amazon Redshift asigna automáticamente las codificaciones de compresión de la siguiente manera:
+ A las columnas que están definidas como claves de ordenación se les asigna una compresión RAW.
+ A las columnas que están definidas como tipos de datos BOOLEAN, REAL o DOUBLE PRECISION se les asigna una compresión RAW.
+ A las columnas que se definen como SMALLINT, INTEGER, BIGINT, DECIMAL, DATE, TIME, TIMETZ, TIMESTAMP o TIMESTAMPTZ se les asigna la compresión AZ64.
+ Las columnas que se definen como CHAR o VARCHAR tienen asignada la compresión LZO.
Considere lo siguiente:
+ Puede definir un máximo de 400 columnas para una clave de ordenación para cada tabla.
+ Puede alterar una clave de ordenación intercalada por una clave de ordenación compuesta o por ninguna clave de ordenación. No obstante, no puede alterar una clave de ordenación compuesta por una clave de ordenación intercalada.
+ Si la clave de ordenación se definió previamente como AUTO, la tabla ya no será candidata para la optimización automática de tablas.
+ Amazon Redshift recomienda utilizar la codificación RAW (sin compresión) para columnas definidas como claves de ordenación. Cuando se modifica una columna para elegirla como clave de ordenación, la compresión de la columna se cambia a la compresión RAW (sin compresión). Esto puede aumentar la cantidad de almacenamiento que requiere la tabla. El aumento del tamaño de la tabla depende de la definición y el contenido específicos de la tabla. Para obtener más información acerca de la compresión, consulte . [Codificaciones de compresión](c_Compression_encodings.md)
Cuando se cargan datos en un tabla, se cargan en el orden definido por la clave de ordenación. Cuando se modifica la clave de ordenación, Amazon Redshift reordena los datos. Para obtener más información acerca de SORTKEY, consulte [CREATE TABLE](r_CREATE_TABLE_NEW.md).
ALTER SORTKEY AUTO
Se trata de una cláusula que modifica la clave de ordenación de la tabla de destino a AUTO o la agrega. ALTER SORTKEY AUTO no se admite en tablas temporales.
Cuando se modifica una clave de ordenación a AUTO, Amazon Redshift conserva la clave de ordenación existente de la tabla.
Si Amazon Redshift determina que una clave de ordenación nueva mejorará el rendimiento de las consultas, Amazon Redshift podría cambiar la clave de ordenación de la tabla en el futuro.
Para obtener más información acerca de SORTKEY AUTO, consulte [CREATE TABLE](r_CREATE_TABLE_NEW.md).
Para ver la clave de ordenación de una tabla, consulte la vista de catálogo del sistema SVV\$1TABLE\$1INFO. Para obtener más información, consulte [SVV\$1TABLE\$1INFO](r_SVV_TABLE_INFO.md). Si desea ver las recomendaciones para tablas de Advisor de Amazon Redshift, consulte la vista de catálogo del sistema SVV\$1ALTER\$1TABLE\$1RECOMMENDATIONS. Para obtener más información, consulte [SVV\$1ALTER\$1TABLE\$1RECOMMENDATIONS](r_SVV_ALTER_TABLE_RECOMMENDATIONS.md). Para ver las acciones llevadas a cabo por Amazon Redshift, consulte la vista de catálogo del sistema SVL\$1AUTO\$1WORKER\$1ACTION. Para obtener más información, consulte [SVL\$1AUTO\$1WORKER\$1ACTION](r_SVL_AUTO_WORKER_ACTION.md).
ALTER SORTKEY NONE
Se trata de una cláusula que quita la clave de ordenación de la tabla de destino.
Si la clave de ordenación se definió previamente como AUTO, la tabla ya no será candidata para la optimización automática de tablas.
ALTER ENCODE AUTO
Se trata de una cláusula que cambia el tipo de codificación de las columnas de la tabla de destino a AUTO. Cuando se cambia la codificación a AUTO, Amazon Redshift conserva el tipo de codificación existente de las columnas de la tabla. Luego, si Amazon Redshift determina que un nuevo tipo de codificación puede mejorar el rendimiento de la consulta, Amazon Redshift puede cambiar el tipo de codificación de las columnas de la tabla.
Si modifica una o más columnas para especificar una codificación, Amazon Redshift ya no ajustará de forma automática la codificación para todas las columnas de la tabla. Las columnas retienen la configuración de la codificación actual.
Las siguientes acciones no afectan al ajuste ENCODE AUTO de la tabla:
+ cambiar el nombre de la tabla
+ modificar el ajuste DISTSTYLE o SORTKEY de la tabla
+ agregar o soltar una columna con un ajuste ENCODE
+ utilizar la opción COMPUPDATE del comando COPY Para obtener más información, consulte [Operaciones de carga de datos](copy-parameters-data-load.md).
Para ver la codificación de una tabla, consulte la vista de catálogo del sistema SVV\$1TABLE\$1INFO. Para obtener más información, consulte [SVV\$1TABLE\$1INFO](r_SVV_TABLE_INFO.md).
RENAME COLUMN *column\$1name* TO *new\$1name*
Cláusula que cambia el nombre de una columna al valor especificado en *new\$1name*. La longitud máxima del nombre de la columna es de 127 bytes; los nombres más largos se truncan en 127 bytes. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
ADD [ COLUMN ] *column\$1name*
Una cláusula que agrega una columna con el nombre especificado a la tabla. Solo se puede agregar una columna en cada instrucción ALTER TABLE.
No se puede agregar una columna que sea la clave de distribución (DISTKEY) o la clave de ordenación (SORTKEY) de la tabla.
No se puede usar un comando ALTER TABLE ADD COLUMN para modificar los siguientes atributos de tabla y de columna:
+ UNIQUE
+ PRIMARY KEY
+ REFERENCES (clave externa)
+ IDENTITY o GENERATED BY DEFAULT AS IDENTITY
La longitud máxima del nombre de la columna es de 127 bytes; los nombres más largos se truncan en 127 bytes. La cantidad máxima de columnas que se pueden definir en una única tabla es 1 600.
Las restricciones siguientes se aplican al agregar una columna a una tabla externa:
+ No se puede agregar una columna a una tabla externa con las restricciones de columna DEFAULT, ENCODE, NOT NULL o NULL.
+ No se pueden agregar columnas a una tabla externa definida con el formato de archivo AVRO.
+ Si están habilitadas las pseudocolumnas, el número máximo de columnas que se pueden definir en una única tabla externa es de 1 598. Si las pseudocolumnas no están habilitadas, el número máximo de columnas que se pueden definir en una única tabla es de 1 600.
Para obtener más información, consulte [CREATE EXTERNAL TABLE](r_CREATE_EXTERNAL_TABLE.md).
*column\$1type*
El tipo de datos de la columna que se agrega. Para las columnas CHAR y VARCHAR, puede usar la palabra clave MAX en lugar de declarar una longitud máxima. MAX establece la longitud máxima en 4 096 bytes para CHAR o 65 535 bytes para VARCHAR. El tamaño máximo del objeto GEOMETRY es 1 048 447 bytes.
Para obtener información acerca de los tipos de datos compatibles con Amazon Redshift, consulte [Tipos de datos](c_Supported_data_types.md).
DEFAULT *default\$1expr*
Una cláusula que asigna un valor de datos predeterminado para la columna. El tipo de datos de *default\$1expr* debe coincidir con el tipo de datos de la columna. El valor DEFAULT debe ser una expresión sin variables. No se permiten subconsultas, referencias cruzadas a otras columnas de la tabla actual ni funciones definidas por el usuario.
El valor *default\$1expr* se utiliza en cualquier operación INSERT en la que no se especifica un valor para la columna. Si no se especifica un valor predeterminado, el valor predeterminado para la columna es nulo.
Si una operación COPY se encuentra con un campo nulo en una columna que tiene un valor DEFAULT y una restricción NOT NULL, el comando COPY inserta el valor de *default\$1expr*.
DEFAULT no se admite para las tablas externas.
ENCODE *encoding*
La codificación de compresión de una columna. Si no se especifica la codificación de compresión para ninguna columna de una tabla o si se especifica la opción ENCODE AUTO para la tabla, Amazon Redshift administra automáticamente la codificación de compresión de todas las columnas de la tabla de manera predeterminada.
Si se especifica la codificación de compresión para cualquier columna de la tabla o si no se especifica la opción ENCODE AUTO para esta, Amazon Redshift asigna automáticamente la codificación de compresión a las columnas para las cuales no se especifica dicha codificación, como se indica a continuación:
+ Por defecto, se asigna una compresión RAW a todas las columnas de tablas temporales.
+ A las columnas que están definidas como claves de ordenación se les asigna una compresión RAW.
+ A las columnas que están definidas como tipos de datos BOOLEAN, REAL, DOUBLE PRECISION, GEOMETRY o GEOGRAPHY se les asigna una compresión RAW.
+ A las columnas que se definen como SMALLINT, INTEGER, BIGINT, DECIMAL, DATE, TIME, TIMETZ, TIMESTAMP o TIMESTAMPTZ se les asigna la compresión AZ64.
+ A las columnas que se definen como CHAR, VARCHAR o VARBYTE se les asigna la compresión LZO.
Si no desea que una columna se comprima, especifique explícitamente la codificación RAW.
Se admiten los siguientes [compression encodings](c_Compression_encodings.md#compression-encoding-list):
+ AZ64
+ BYTEDICT
+ DELTA
+ DELTA32K
+ LZO
+ MOSTLY8
+ MOSTLY16
+ MOSTLY32
+ RAW (sin comprimir)
+ RUNLENGTH
+ TEXT255
+ TEXT32K
+ ZSTD
ENCODE no se admite para las tablas externas.
NOT NULL \$1 NULL
NOT NULL indica que la columna no puede contener valores nulos. NULL, el valor predeterminado, especifica que la columna acepta valores nulos.
NOT NULL y NULL no se admiten para las tablas externas.
COLLATE \$1 CASE\$1SENSITIVE \$1 CS \$1 CASE\$1INSENSITIVE \$1 CI \$1
Una cláusula que especifica si la búsqueda o comparación de cadenas en la columna distingue entre mayúsculas y minúsculas o no. El valor predeterminado es el mismo que la configuración actual de distinción entre mayúsculas y minúsculas de la base de datos.
Para encontrar información de la intercalación de bases de datos, utilice el siguiente comando:
```
SELECT db_collation();
db_collation
----------------
case_sensitive
(1 row)
```
CASE\$1SENSITIVE y CS son intercambiables y producen los mismos resultados. Del mismo modo, CASE\$1INSENSITIVE y CI son intercambiables y producen los mismos resultados.
DROP [ COLUMN ] *column\$1name*
El nombre de la columna que se debe eliminar de la tabla.
No se puede eliminar la última columna de una tabla. Una tabla debe tener como mínimo una columna.
No se puede eliminar una columna que sea la clave de distribución (DISTKEY) o la clave de ordenación (SORTKEY) de la tabla. El comportamiento predeterminado de DROP COLUMN es RESTRICT si la columna tiene objetos dependientes, como vista, clave principal, clave externa o restricción UNIQUE.
Las restricciones siguientes se aplican al quitar una columna de una tabla externa:
+ No se puede eliminar una columna de una tabla externa si la columna se utiliza como partición.
+ No se puede eliminar una columna de una tabla externa definida con el formato de archivo AVRO.
+ RESTRICT y CASCADE no se tienen en cuenta para las tablas externas.
+ No puede eliminar las columnas de la tabla de políticas a la que se hace referencia dentro de la definición de política a menos que elimine o desactive la política. Esto también se aplica cuando se especifica la opción CASCADE. Puede eliminar otras columnas de la tabla de políticas.
Para obtener más información, consulte [CREATE EXTERNAL TABLE](r_CREATE_EXTERNAL_TABLE.md).
RESTRICT
Cuando se usa con DROP COLUMN, RESTRICT significa que la columna que se va a eliminar no se eliminará, en los siguientes casos:
+ Si una vista definida hace referencia a la columna que desea eliminar
+ Si una clave externa hace referencia a la columna
+ Si la columna forma parte de una clave multiparte
RESTRICT no puede utilizarse con CASCADE.
RESTRICT y CASCADE no se tienen en cuenta para las tablas externas.
CASCADE
Cuando se usa con DROP COLUMN, elimina la columna especificada y todos los elementos que dependen de esa columna. CASCADE no puede utilizarse con RESTRICT.
RESTRICT y CASCADE no se tienen en cuenta para las tablas externas.
Las siguientes opciones se aplican solo a tablas externas.
SET LOCATION \$1 's3://*bucket/folder*/' \$1 's3://*bucket/manifest\$1file*' \$1
Se trata de la ruta a la carpeta de Amazon S3 que contiene los archivos de datos o un archivo de manifiesto que incluye una lista de rutas de objetos de Amazon S3. Los buckets deben estar en la misma región de AWS que el clúster de Amazon Redshift. Para obtener una lista de las regiones de AWS admitidas, consulte [Limitaciones de Amazon Redshift Spectrum](c-spectrum-considerations.md). Para obtener más información acerca del uso de un archivo de manifiesto, consulte LOCATION en la sección [Parameters](r_CREATE_EXTERNAL_TABLE.md#r_CREATE_EXTERNAL_TABLE-parameters) de la documentación sobre el comando CREATE EXTERNAL TABLE.
SET FILE FORMAT *format*
El formato de archivo para los archivos de datos externos.
Los formatos válidos son los siguientes:
+ AVRO
+ PARQUET
+ RCFILE
+ SEQUENCEFILE
+ TEXTFILE
SET TABLE PROPERTIES ( '*property\$1name*'='*property\$1value*')
Cláusula que establece la definición de las propiedades de una tabla externa.
Las propiedades de tabla distinguen entre mayúsculas y minúsculas.
'numRows'='*row\$1count*'
Una propiedad que establece el valor de numRows para la definición de la tabla. Para actualizar de forma explícita las estadísticas de una tabla externa, establezca la propiedad numRows de manera que indique el tamaño de la tabla. Amazon Redshift no analiza las tablas externas para generar las estadísticas de las tablas que el optimizador de consultas emplea a la hora de crear un plan de consulta. Si no se establecen las estadísticas de la tabla que corresponden a una tabla externa, Amazon Redshift crea un plan de ejecución de consultas. El plan se basa en la suposición de que las tablas externas son las tablas más grandes y las tablas locales son las tablas más pequeñas
'skip.header.line.count'='*line\$1count*'
Una propiedad que establece el número de filas que se omiten al principio de cada archivo de código fuente.
PARTITION ( *partition\$1column*=*partition\$1value* [, ...] SET LOCATION \$1 's3://*bucket*/*folder*' \$1 's3://*bucket*/*manifest\$1file*' \$1
Una cláusula que configura una nueva ubicación para una o más columnas de partición.
ADD [ IF NOT EXISTS ] PARTITION ( *partition\$1column*=*partition\$1value* [, ...] ) LOCATION \$1 's3://*bucket*/*folder*' \$1 's3://*bucket*/*manifest\$1file*' \$1 [, ... ]
Una cláusula que agrega una o más particiones. Puede especificar múltiples cláusulas PARTITION mediante una única instrucción ALTER TABLE … ADD.
Si usa el catálogo de AWS Glue, puede agregar hasta 100 particiones mediante una única instrucción ALTER TABLE.
La cláusula IF NOT EXISTS indica que si la partición especificada ya existe, el comando no debería realizar ningún cambio. También indica que el comando debe devolver un mensaje en el que se indique que la tabla existe, en lugar de terminar con un error. Esta cláusula es útil cuando se realiza scripting, para que el script no produzca un error si ALTER TABLE intenta agregar una partición que ya existe.
DROP PARTITION (*partition\$1column*=*partition\$1value* [, ...] )
Una cláusula que elimina la partición especificada. Eliminar una partición modifica solo los metadatos de la tabla externa. Los datos de Amazon S3 no se ven afectados.
ROW LEVEL SECURITY \$1 ON \$1 OFF \$1 [ CONJUNCTION TYPE \$1 AND \$1 OR \$1 ] [ FOR DATASHARES ]
Es una cláusula que activa o desactiva la seguridad de nivel de fila para una relación.
Cuando la seguridad de nivel de fila está activada para una relación, solo puede leer las filas a las que la política de seguridad de nivel de fila le permite acceder. Si no hay ninguna política que le conceda acceso a la relación, no podrá ver ninguna fila de la relación. Solo los superusuarios y los usuarios o roles que tienen el rol `sys:secadmin` pueden establecer la cláusula ROW LEVEL SECURITY. Para obtener más información, consulte [Seguridad de nivel básico](t_rls.md). Esta instrucción se admite en la base de datos conectada o en una base de datos con permisos federados de Amazon Redshift. La cláusula FOR DATASHARES no se admite en bases de datos con permisos federados de Amazon Redshift.
+ [ CONJUNCTION TYPE \$1 AND \$1 OR \$1 ]
Es una cláusula que le permite elegir el tipo de conjunción de la política de seguridad a nivel de fila para una relación. Si se asocian varias políticas de seguridad en el nivel de fila a una relación, puede combinarlas con la cláusula AND u OR. De forma predeterminada, Amazon Redshift combina las políticas de RLS con la cláusula AND. Los superusuarios, usuarios o roles que tienen el rol `sys:secadmin` pueden usar esta cláusula para definir el tipo de conjunción de la política de seguridad de nivel de fila para una relación. Para obtener más información, consulte [Combinación de varias políticas por usuario](t_rls_combine_policies.md).
+ PARA RECURSOS COMPARTIDOS DE DATOS
Es una cláusula que determina si se puede acceder a una relación protegida por RLS a través de recursos compartidos de datos. De forma predeterminada, no se puede acceder a una relación protegida por RLS a través de un recurso compartido de datos. Un comando ALTER TABLE ROW LEVEL SECURITY ejecutado con esta cláusula solo afecta a la propiedad de accesibilidad de recurso compartido de datos de la relación. La propiedad ROW LEVEL SECURITY no ha cambiado.
Si hace que una relación protegida por RLS sea accesible a través de recursos compartidos de datos, la relación no tendrá seguridad de nivel de fila en la base de datos de recurso compartido de datos del lado del consumidor. La relación conserva su propiedad RLS del lado del productor.
MASKING \$1 ON \$1 OFF \$1 FOR DATASHARES
Es una cláusula que determina si se puede acceder a una relación protegida por DDM a través de recursos compartidos de datos. De forma predeterminada, no se puede acceder a una relación protegida por DDM a través de un recurso compartido de datos. Si hace que una relación protegida por DDM sea accesible a través de recursos compartidos de datos, la relación no tendrá protección con enmascaramiento en la base de datos de recurso compartido de datos del lado del consumidor. La relación conserva su propiedad de enmascaramiento del lado del productor. Solo los superusuarios y los usuarios o roles que tengan el rol `sys:secadmin` pueden establecer la cláusula MASKING FOR DATASHARES. Para obtener más información, consulte [Enmascaramiento de datos dinámico](t_ddm.md).
## Ejemplos
Para ver ejemplos que muestran cómo utilizar el comando ALTER TABLE, consulte lo siguiente.
+ [Ejemplos de ALTER TABLE](r_ALTER_TABLE_examples_basic.md)
+ [Ejemplos de ALTER EXTERNAL TABLE](r_ALTER_TABLE_external-table.md)
+ [Ejemplos de ALTER TABLE ADD y DROP COLUMN](r_ALTER_TABLE_COL_ex-add-drop.md)
# Ejemplos de ALTER TABLE
En los siguientes ejemplos se muestra el uso básico del comando ALTER TABLE.
## Cambiar el nombre de una tabla o una vista
El siguiente comando cambia el nombre de la tabla USERS a USERS\$1BKUP:
```
alter table users
rename to users_bkup;
```
También puede utilizar este tipo de comando para cambiar el nombre de una vista.
## Cambiar el propietario de una tabla o vista
El siguiente comando cambia el propietario de la tabla VENUE al usuario DWUSER:
```
alter table venue
owner to dwuser;
```
Los siguientes comandos crean una vista y, luego, cambian su propietario:
```
create view vdate as select * from date;
alter table vdate owner to vuser;
```
## Cambiar el nombre de una columna
El siguiente comando cambia el nombre de la columna VENUESEATS de la tabla VENUE a VENUESIZE:
```
alter table venue
rename column venueseats to venuesize;
```
## Eliminar la restricción de una tabla
Para eliminar la restricción de una tabla, como clave principal, clave externa o restricción única, primero debe buscar el nombre interno de la restricción. Y, a continuación, especificar el nombre de la restricción en el comando ALTER TABLE. En el siguiente ejemplo, se buscan las restricciones de la tabla CATEGORY y, luego, se elimina la clave principal con el nombre `category_pkey`.
```
select constraint_name, constraint_type
from information_schema.table_constraints
where constraint_schema ='public'
and table_name = 'category';
constraint_name | constraint_type
----------------+----------------
category_pkey | PRIMARY KEY
alter table category
drop constraint category_pkey;
```
## Modificar una columna VARCHAR
Para ahorrar espacio de almacenamiento, puede definir inicialmente una tabla con columnas VARCHAR con el tamaño mínimo necesario para sus requisitos de datos actuales. Si más adelante, para dar cabida a cadenas más largas, puede modificar la tabla para aumentar el tamaño de la columna.
En el siguiente ejemplo, se cambia el tamaño de la columna EVENTNAME a VARCHAR(300).
```
alter table event alter column eventname type varchar(300);
```
## Modificar una columna VARBYTE
Para ahorrar espacio de almacenamiento, puede definir inicialmente una tabla con columnas VARBYTE con el tamaño mínimo necesario para sus requisitos de datos actuales. Si más adelante, para dar cabida a cadenas más largas, puede modificar la tabla para aumentar el tamaño de la columna.
En el siguiente ejemplo, se cambia el tamaño de la columna EVENTNAME a VARBYTE(300).
```
alter table event alter column eventname type varbyte(300);
```
## Modificar la codificación de compresión de una columna
Puede modificar la codificación de compresión de una columna. A continuación, encontrará un conjunto de ejemplos que demuestran este enfoque. La definición de la tabla para estos ejemplos es la siguiente.
```
create table t1(c0 int encode lzo, c1 bigint encode zstd, c2 varchar(16) encode lzo, c3 varchar(32) encode zstd);
```
La siguiente instrucción modifica la codificación de compresión de la columna c0 de codificación LZO a AZ64.
```
alter table t1 alter column c0 encode az64;
```
La siguiente instrucción modifica la codificación de compresión de la columna c1 de codificación Zstandard a AZ64.
```
alter table t1 alter column c1 encode az64;
```
La siguiente instrucción modifica la codificación de compresión de la columna c2 de codificación LZO a codificación por diccionario de bytes.
```
alter table t1 alter column c2 encode bytedict;
```
La siguiente instrucción modifica la codificación de compresión de la columna c3 de codificación Zstandard a Runlength.
```
alter table t1 alter column c3 encode runlength;
```
## Modificar una columna DISTSTYLE KEY DISTKEY
Los siguientes ejemplos muestran cómo cambiar DISTSTYLE y DISTKEY en una tabla.
Crear una tabla con un estilo de distribución EVEN. LA vista SVV\$1TABLE\$1INFO muestra que DISTSYLE es EVEN.
```
create table inventory(
inv_date_sk int4 not null ,
inv_item_sk int4 not null ,
inv_warehouse_sk int4 not null ,
inv_quantity_on_hand int4
) diststyle even;
Insert into inventory values(1,1,1,1);
select "table", "diststyle" from svv_table_info;
table | diststyle
-----------+----------------
inventory | EVEN
```
Altere la tabla DISTKEY a `inv_warehouse_sk`. La vista SVV\$1TABLE\$1INFO muestra la columna `inv_warehouse_sk` como la clave de distribución resultante.
```
alter table inventory alter diststyle key distkey inv_warehouse_sk;
select "table", "diststyle" from svv_table_info;
table | diststyle
-----------+-----------------------
inventory | KEY(inv_warehouse_sk)
```
Altere la tabla DISTKEY a `inv_item_sk`. La vista SVV\$1TABLE\$1INFO muestra la columna `inv_item_sk` como la clave de distribución resultante.
```
alter table inventory alter distkey inv_item_sk;
select "table", "diststyle" from svv_table_info;
table | diststyle
-----------+-----------------------
inventory | KEY(inv_item_sk)
```
## Modificar una tabla a DISTSTYLE ALL
En los ejemplos siguientes se muestra cómo cambiar una tabla a DISTSTYLE ALL.
Crear una tabla con un estilo de distribución EVEN. LA vista SVV\$1TABLE\$1INFO muestra que DISTSYLE es EVEN.
```
create table inventory(
inv_date_sk int4 not null ,
inv_item_sk int4 not null ,
inv_warehouse_sk int4 not null ,
inv_quantity_on_hand int4
) diststyle even;
Insert into inventory values(1,1,1,1);
select "table", "diststyle" from svv_table_info;
table | diststyle
-----------+----------------
inventory | EVEN
```
Cambie la tabla DISTSTYLE a ALL. La vista SVV\$1TABLE\$1INFO muestra el DISTSYTLE modificado.
```
alter table inventory alter diststyle all;
select "table", "diststyle" from svv_table_info;
table | diststyle
-----------+----------------
inventory | ALL
```
## Modificar una tabla SORTKEY
Puede modificar una tabla para que tenga una clave de ordenación compuesta o ninguna clave de ordenación.
En la siguiente definición de la tabla, la tabla `t1` se define con una sortkey intercalada.
```
create table t1 (c0 int, c1 int) interleaved sortkey(c0, c1);
```
El siguiente comando modifica la tabla de una clave de ordenación intercalada a una clave de ordenación compuesta.
```
alter table t1 alter sortkey(c0, c1);
```
El siguiente comando modifica la tabla para eliminar la clave de ordenación intercalada.
```
alter table t1 alter sortkey none;
```
En la siguiente definición de la tabla, la tabla `t1` se define con una columna `c0` como sortkey.
```
create table t1 (c0 int, c1 int) sortkey(c0);
```
El siguiente comando modifica la tabla `t1` a una clave de ordenación compuesta.
```
alter table t1 alter sortkey(c0, c1);
```
## Modificar una tabla para pasarla a ENCODE AUTO
En el siguiente ejemplo, se muestra cómo modificar una tabla para pasarla a ENCODE AUTO.
A continuación, se muestra la definición de la tabla para este ejemplo. La columna `c0` se define con el tipo de codificación AZ64 y la columna `c1` se define con el tipo de codificación LZO.
```
create table t1(c0 int encode AZ64, c1 varchar encode LZO);
```
Para esta tabla, la siguiente instrucción modifica la codificación a AUTO.
```
alter table t1 alter encode auto;
```
En el siguiente ejemplo, se muestra cómo modificar una tabla para quitar el ajuste ENCODE AUTO.
A continuación, se muestra la definición de la tabla para este ejemplo. Las columnas de la tabla se definen sin codificación. En este caso, la codificación adopta la opción ENCODE AUTO de manera predeterminada.
```
create table t2(c0 int, c1 varchar);
```
Para esta tabla, la siguiente instrucción modifica la codificación de la columna c0 a LZO. La codificación de la tabla ya no se establece en ENCODE AUTO.
```
alter table t2 alter column c0 encode lzo;;
```
## Modificar el control de seguridad de nivel de fila
El siguiente comando desactiva la RLS de la tabla:
```
ALTER TABLE tickit_category_redshift ROW LEVEL SECURITY OFF;
```
El siguiente comando activa la RLS para la tabla:
```
ALTER TABLE tickit_category_redshift ROW LEVEL SECURITY ON;
```
El siguiente comando activa la RLS para la tabla y la hace accesible a través de recursos compartidos de datos:
```
ALTER TABLE tickit_category_redshift ROW LEVEL SECURITY ON;
ALTER TABLE tickit_category_redshift ROW LEVEL SECURITY FOR DATASHARES OFF;
```
El siguiente comando activa la RLS para la tabla y la hace inaccesible a través de recursos compartidos de datos:
```
ALTER TABLE tickit_category_redshift ROW LEVEL SECURITY ON;
ALTER TABLE tickit_category_redshift ROW LEVEL SECURITY FOR DATASHARES ON;
```
El siguiente comando activa la RLS y establece el tipo de conjunción RLS en OR para la tabla:
```
ALTER TABLE tickit_category_redshift ROW LEVEL SECURITY ON CONJUNCTION TYPE OR;
```
El siguiente comando activa la RLS y establece el tipo de conjunción RLS en AND para la tabla:
```
ALTER TABLE tickit_category_redshift ROW LEVEL SECURITY ON CONJUNCTION TYPE AND;
```
# Ejemplos de ALTER EXTERNAL TABLE
En los siguientes ejemplos, se utiliza un bucket de Amazon S3 situado en la región Este de EE.UU. (Norte de Virginia) (`us-east-1`) Región de AWS y las tablas de ejemplo creadas en [Ejemplos](r_CREATE_EXTERNAL_TABLE_examples.md) para CREATE TABLE. Para obtener más información acerca de cómo utilizar las particiones con tablas externas, consulte [Partición de tablas externas de Redshift Spectrum](c-spectrum-external-tables.md#c-spectrum-external-tables-partitioning).
En los siguientes conjuntos de ejemplos se configura la propiedad numRows de la tabla para la tabla externa SPECTRUM.SALES en 170 000 filas.
```
alter table spectrum.sales
set table properties ('numRows'='170000');
```
En el siguiente ejemplo, se cambia la ubicación de la tabla externa SPECTRUM.SALES.
```
alter table spectrum.sales
set location 's3://redshift-downloads/tickit/spectrum/sales/';
```
En el siguiente ejemplo, se cambia el formato de la tabla externa SPECTRUM.SALES a Parquet.
```
alter table spectrum.sales
set file format parquet;
```
En el siguiente ejemplo, se agrega una partición para la tabla SPECTRUM.SALES\$1PART.
```
alter table spectrum.sales_part
add if not exists partition(saledate='2008-01-01')
location 's3://redshift-downloads/tickit/spectrum/sales_partition/saledate=2008-01/';
```
En el siguiente ejemplo, se agregan tres particiones para la tabla SPECTRUM.SALES\$1PART.
```
alter table spectrum.sales_part add if not exists
partition(saledate='2008-01-01')
location 's3://redshift-downloads/tickit/spectrum/sales_partition/saledate=2008-01/'
partition(saledate='2008-02-01')
location 's3://redshift-downloads/tickit/spectrum/sales_partition/saledate=2008-02/'
partition(saledate='2008-03-01')
location 's3://redshift-downloads/tickit/spectrum/sales_partition/saledate=2008-03/';
```
En el siguiente ejemplo, se modifica SPECTRUM.SALES\$1PART para eliminar la partición con `saledate='2008-01-01''`.
```
alter table spectrum.sales_part
drop partition(saledate='2008-01-01');
```
En el siguiente ejemplo, se establece una ruta nueva de Amazon S3 para la partición con `saledate='2008-01-01'`.
```
alter table spectrum.sales_part
partition(saledate='2008-01-01')
set location 's3://redshift-downloads/tickit/spectrum/sales_partition/saledate=2008-01-01/';
```
En el siguiente ejemplo, se cambia el nombre de `sales_date` a `transaction_date`.
```
alter table spectrum.sales rename column sales_date to transaction_date;
```
En el siguiente ejemplo, se establece una asignación de columna con una asignación de posición en una tabla externa que utiliza el formato ORC (Optimized Row Columnar).
```
alter table spectrum.orc_example
set table properties('orc.schema.resolution'='position');
```
En el siguiente ejemplo, se establece una asignación de columna con una asignación de nombre en una tabla externa que utiliza el formato ORC.
```
alter table spectrum.orc_example
set table properties('orc.schema.resolution'='name');
```
# Ejemplos de ALTER TABLE ADD y DROP COLUMN
En los siguientes ejemplos se muestra cómo usar ALTER TABLE para agregar y eliminar la columna de una tabla básica y, también, cómo eliminar una columna con un objeto dependiente.
## Utilizar ADD y, luego, DROP en una columna básica
En el siguiente ejemplo, se agrega una columna FEEDBACK\$1SCORE independiente a la tabla USERS. Esta columna contiene un valor entero, y el valor predeterminado de esta columna es NULL (no hay marcador de retroalimentación).
En primer lugar, consulte la tabla de catálogos PG\$1TABLE\$1DEF para ver el esquema de la tabla USERS:
```
column | type | encoding | distkey | sortkey
--------------+------------------------+----------+---------+--------
userid | integer | delta | true | 1
username | character(8) | lzo | false | 0
firstname | character varying(30) | text32k | false | 0
lastname | character varying(30) | text32k | false | 0
city | character varying(30) | text32k | false | 0
state | character(2) | bytedict | false | 0
email | character varying(100) | lzo | false | 0
phone | character(14) | lzo | false | 0
likesports | boolean | none | false | 0
liketheatre | boolean | none | false | 0
likeconcerts | boolean | none | false | 0
likejazz | boolean | none | false | 0
likeclassical | boolean | none | false | 0
likeopera | boolean | none | false | 0
likerock | boolean | none | false | 0
likevegas | boolean | none | false | 0
likebroadway | boolean | none | false | 0
likemusicals | boolean | none | false | 0
```
Ahora, agregue la columna feedback\$1score:
```
alter table users
add column feedback_score int
default NULL;
```
Seleccione la columna FEEDBACK\$1SCORE de USERS para verificar que se haya agregado:
```
select feedback_score from users limit 5;
feedback_score
----------------
NULL
NULL
NULL
NULL
NULL
```
Arrastre la columna para restablecer la DDL original:
```
alter table users drop column feedback_score;
```
## Eliminación de una columna con un objeto dependiente
En el siguiente ejemplo, se elimina una columna que tiene un objeto dependiente. Como resultado, también se elimina el objeto dependiente.
Para comenzar, agregue la columna FEEDBACK\$1SCORE a la tabla USERS nuevamente:
```
alter table users
add column feedback_score int
default NULL;
```
Luego, cree una vista de la tabla USERS denominada USERS\$1VIEW:
```
create view users_view as select * from users;
```
Ahora, pruebe eliminar la columna FEEDBACK\$1SCORE de la tabla USERS. Esta instrucción DROP usa el comportamiento predeterminado (RESTRICT):
```
alter table users drop column feedback_score;
```
Amazon Redshift muestra un mensaje de error en el que se indica que la columna no puede eliminarse porque otro objeto depende de ella.
Pruebe eliminar la columna FEEDBACK\$1SCORE nuevamente y, esta vez, especifique CASCADE para eliminar todos los objetos dependientes:
```
alter table users
drop column feedback_score cascade;
```
# ALTER TABLE APPEND
Adjunta filas en una tabla de destino al mover datos de una tabla de origen existente. Los datos de la tabla de origen se mueven a las columnas correspondientes de la tabla de destino. El orden de la columna no es importante. Después de que se agregan los datos correctamente a la tabla de destino, la tabla de origen queda vacía. Por lo general, ALTER TABLE APPEND es mucho más rápida que una operación [CREATE TABLE AS](r_CREATE_TABLE_AS.md) o [INSERT](r_INSERT_30.md) INTO similar debido a que los datos se mueven, no se duplican.
**nota**
ALTER TABLE APPEND mueve bloques de datos entre la tabla de origen y la tabla de destino. Para mejorar el rendimiento, ALTER TABLE APPEND no compacta el almacenamiento como parte de la operación APPEND. Como resultado, el uso del almacenamiento aumenta temporalmente. Parar reclamar el espacio, ejecute una operación [VACUUM](r_VACUUM_command.md).
Las columnas con los mismos nombres también deben tener atributos de columna idénticos. Si la tabla de origen o la tabla de destino contienen columnas que no existen en la otra tabla, use los parámetros IGNOREEXTRA o FILLTARGET para especificar cómo se deben administrar las columnas adicionales.
No se puede agregar una columna de identidad. El comando fallará si ambas tablas incluyen una columna de identidad. Si solo una tabla tiene una columna de identidad, incluya el parámetro FILLTARGET o IGNOREEXTRA. Para obtener más información, consulte [Notas de uso acerca de ALTER TABLE APPEND](#r_ALTER_TABLE_APPEND_usage).
Puede anexar una columna GENERATED BY DEFAULT AS IDENTITY. Puede actualizar las columnas definidas como GENERATED BY DEFAULT AS IDENTITY con los valores proporcionados. Para obtener más información, consulte [Notas de uso acerca de ALTER TABLE APPEND](#r_ALTER_TABLE_APPEND_usage).
La tabla de destino debe ser una tabla permanente. No obstante, el origen puede ser una tabla permanente o una vista materializada configurada para la ingesta de streaming. Ambos objetos deben usar el mismo estilo de distribución y la misma clave de distribución, si se ha definido una. Si los objetos están ordenados, ambos deben usar el mismo estilo de ordenación y definir las mismas columnas como claves de ordenación.
Un comando ALTER TABLE APPEND se confirma automáticamente apenas se completa la operación. No se puede revertir. No puede ejecutar ALTER TABLE APPEND en un bloque de transacción (BEGIN … END). Para obtener más información acerca de las transacciones, consulte [Niveles de aislamiento en Amazon Redshift](c_serial_isolation.md).
## Privilegios necesarios
Según el comando ALTER TABLE APPEND, se requiere uno de los siguientes privilegios:
+ Superusuario
+ Usuarios con el privilegio de sistema ALTER TABLE
+ Usuarios con los privilegios DELETE y SELECT en la tabla de origen y el privilegio INSERT en la tabla de destino
## Sintaxis
```
ALTER TABLE target_table_name APPEND FROM [ source_table_name | source_materialized_view_name ]
[ IGNOREEXTRA | FILLTARGET ]
```
La adición desde una vista materializada solo funciona en el caso en que la vista materializada esté configurada para [Ingesta de streaming a una vista materializada](materialized-view-streaming-ingestion.md).
## Parameters
*target\$1table\$1name*
El nombre de la tabla a la que se agregan las filas. Especifique solo el nombre de la tabla o use el formato *schema\$1name.table\$1name (nombre-de\$1esquema.nombre\$1de\$1tabla)* para usar un esquema específico. La tabla de destino debe ser una tabla permanente existente.
FROM *source\$1table\$1name*
El nombre de la tabla que proporciona las filas que se agregarán. Especifique solo el nombre de la tabla o use el formato *schema\$1name.table\$1name (nombre-de\$1esquema.nombre\$1de\$1tabla)* para usar un esquema específico. La tabla de origen debe ser una tabla permanente existente.
FROM *source\$1materialized\$1view\$1name*
El nombre de la vista materializada que proporciona las filas que se agregarán. La adición desde una vista materializada solo funciona en el caso en que la vista materializada esté configurada para [Ingesta de streaming a una vista materializada](materialized-view-streaming-ingestion.md). La vista materializada de origen ya debe existir.
IGNOREEXTRA
Una palabra clave que especifica si la tabla de origen incluye columnas que no están presentes en la tabla de destino; los datos de las columnas adicionales deben descartarse. No puede utilizar IGNOREEXTRA con FILLTARGET.
FILLTARGET
Una palabra clave que especifica si la tabla de destino incluye columnas que no están presentes en la tabla de origen; las columnas deben completarse con el valor de la columna [DEFAULT](r_CREATE_TABLE_NEW.md#create-table-default), si se definió uno, o con el valor NULL. No puede utilizar IGNOREEXTRA con FILLTARGET.
## Notas de uso acerca de ALTER TABLE APPEND
+ ALTER TABLE APPEND mueve solo las columnas idénticas de la tabla de origen a la tabla de destino. El orden de la columna no es importante.
+ Si la tabla de origen o la tabla de destino contienen columnas adicionales, utilice FILLTARGET o IGNOREEXTRA según las siguientes reglas:
+ Si la tabla de origen contiene columnas que no existen en la tabla de destino, incluya IGNOREEXTRA. El comando ignora las columnas adicionales de la tabla de origen.
+ Si la tabla de destino contiene columnas que no existen en la tabla de origen, incluya FILLTARGET. El comando rellena las columnas adicionales de la tabla de destino con el valor de columna predeterminado, con el valor IDENTITY, si se definió uno, o con NULL.
+ El comando fallará si ambas tablas, la de origen y la de destino, contienen columnas adicionales. No pueden utilizar ambos parámetros, FILLTARGET e IGNOREEXTRA.
+ El comando fallará si hay una columna con el mismo nombre, pero con diferentes atributos, en ambas tablas. Las columnas con nombres similares deben tener los siguientes atributos en común:
+ Tipo de datos
+ Tamaño de la columna
+ Codificación de compresión
+ Sin valores nulos
+ Estilo de ordenación
+ Columnas con clave de ordenación
+ Estilo de distribución
+ Columnas con clave de distribución
+ No se puede agregar una columna de identidad. El comando fallará si ambas tablas, la de origen y la de destino, tienen columnas de identidad. Si solo la tabla de origen tiene una columna de identidad, incluya el parámetro IGNOREEXTRA para ignorar la columna de identidad. Si solo la tabla de destino tiene una columna de identidad, incluya el parámetro FILLTARGET para completar la columna de identidad según la cláusula IDENTITY definida para la tabla. Para obtener más información, consulte [DEFAULT](r_CREATE_TABLE_NEW.md#create-table-default).
+ Puede anexar una columna de identidad predeterminada con la instrucción ALTER TABLE APPEND. Para obtener más información, consulte [CREATE TABLE](r_CREATE_TABLE_NEW.md).
+ Las operaciones ALTER TABLE APPEND mantienen bloqueos exclusivos cuando se ejecutan en vistas materializadas de streaming de Amazon Redshift conectadas a cualquiera de las siguientes opciones:
+ Un flujo de datos de Amazon Kinesis
+ Una transmisión gestionada de Amazon para el tema de Apache Kafka
+ Una transmisión externa compatible, como un tema de Confluent Cloud Kafka
Para obtener más información, consulte [Ingesta de streaming a una vista materializada](materialized-view-streaming-ingestion.md).
## Ejemplos de ALTER TABLE APPEND
Supongamos que su organización mantiene una tabla, SALES\$1MONTHLY, para capturar transacciones de venta actuales. Desea mover datos de la tabla de transacción a la tabla SALES, todos los meses.
Puede utilizar los comandos INSERT INTO y TRUNCATE para llevar a cabo la tarea.
```
insert into sales (select * from sales_monthly);
truncate sales_monthly;
```
No obstante, puede realizar la misma operación de una manera mucho más eficiente con el comando ALTER TABLE APPEND.
Primero, consulte la tabla de catálogo del sistema [PG\$1TABLE\$1DEF](r_PG_TABLE_DEF.md) para verificar que ambas tablas tengan las mismas columnas con atributos de columna idénticos.
```
select trim(tablename) as table, "column", trim(type) as type,
encoding, distkey, sortkey, "notnull"
from pg_table_def where tablename like 'sales%';
table | column | type | encoding | distkey | sortkey | notnull
-----------+------------+-----------------------------+----------+---------+---------+--------
sales | salesid | integer | lzo | false | 0 | true
sales | listid | integer | none | true | 1 | true
sales | sellerid | integer | none | false | 2 | true
sales | buyerid | integer | lzo | false | 0 | true
sales | eventid | integer | mostly16 | false | 0 | true
sales | dateid | smallint | lzo | false | 0 | true
sales | qtysold | smallint | mostly8 | false | 0 | true
sales | pricepaid | numeric(8,2) | delta32k | false | 0 | false
sales | commission | numeric(8,2) | delta32k | false | 0 | false
sales | saletime | timestamp without time zone | lzo | false | 0 | false
salesmonth | salesid | integer | lzo | false | 0 | true
salesmonth | listid | integer | none | true | 1 | true
salesmonth | sellerid | integer | none | false | 2 | true
salesmonth | buyerid | integer | lzo | false | 0 | true
salesmonth | eventid | integer | mostly16 | false | 0 | true
salesmonth | dateid | smallint | lzo | false | 0 | true
salesmonth | qtysold | smallint | mostly8 | false | 0 | true
salesmonth | pricepaid | numeric(8,2) | delta32k | false | 0 | false
salesmonth | commission | numeric(8,2) | delta32k | false | 0 | false
salesmonth | saletime | timestamp without time zone | lzo | false | 0 | false
```
A continuación, observe el tamaño de cada tabla.
```
select count(*) from sales_monthly;
count
-------
2000
(1 row)
select count(*) from sales;
count
-------
412,214
(1 row)
```
Ahora ejecute el siguiente comando ALTER TABLE APPEND.
```
alter table sales append from sales_monthly;
```
Observe el tamaño de cada tabla nuevamente. La tabla SALES\$1MONTHLY ahora tiene 0 filas, y la tabla SALES tiene 2 000 filas más.
```
select count(*) from sales_monthly;
count
-------
0
(1 row)
select count(*) from sales;
count
-------
414214
(1 row)
```
Si la tabla de origen contiene más columnas que la tabla de destino, especifique el parámetro IGNOREEXTRA. En el siguiente ejemplo, se usa el parámetro IGNOREEXTRA para ignorar las columnas adicionales de la tabla SALES\$1LISTING cuando agrega columnas en la tabla SALES.
```
alter table sales append from sales_listing ignoreextra;
```
Si la tabla de destino contiene más columnas que la tabla de origen, especifique el parámetro FILLTARGET. En el siguiente ejemplo, se usa el parámetro FILLTARGET para completar columnas en la tabla SALES\$1REPORT que no existen en la tabla SALES\$1MONTH.
```
alter table sales_report append from sales_month filltarget;
```
A continuación, se muestra un ejemplo de cómo utilizar ALTER TABLE APPEND con una vista materializada como origen.
```
ALTER TABLE target_tbl APPEND FROM my_streaming_materialized_view;
```
Los nombres de la tabla y de la vista materializada de este ejemplo son muestras. La adición desde una vista materializada solo funciona en el caso en que la vista materializada esté configurada para [Ingesta de streaming a una vista materializada](materialized-view-streaming-ingestion.md). Mueve todos los registros de la vista materializada de origen a una tabla de destino con el mismo esquema que la vista materializada y deja la vista materializada intacta. Este es el mismo comportamiento que cuando el origen de los datos es una tabla.
# ALTER TEMPLATE
Cambia la definición de una plantilla existente. Utilice este comando para cambiar el nombre de una plantilla, cambiar el propietario de una plantilla, añadir o eliminar parámetros de la definición de la plantilla, o establecer valores de parámetros.
## Privilegios necesarios
Para modificar una plantilla, debe tener una de las siguientes opciones:
+ Privilegios de superusuario
+ Privilegio ALTER TEMPLATE y privilegio USAGE sobre el esquema que contiene la plantilla.
## Sintaxis
```
ALTER TEMPLATE [database_name.][schema_name.]template_name
{
RENAME TO new_name
| OWNER TO new_owner
| ADD parameter [AS] [value]
| DROP parameter
| SET parameter TO value1 [, parameter2 TO value2 , ...]
};
```
## Parameters
*database\$1name*
(Opcional) El nombre de la base de datos en la que se crea la plantilla. Si no se especifica, se utiliza la base de datos actual.
*schema\$1name*
(Opcional) El nombre del esquema en el que se crea la plantilla. Si no se especifica, la plantilla se busca en la ruta de búsqueda actual.
*template\$1name*
El nombre de la plantilla que se va a modificar.
RENAME TO
Una cláusula que cambia el nombre de la plantilla.
*new\$1name*
El nuevo nombre de la plantilla. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
OWNER TO
Una cláusula que cambia el propietario de la plantilla.
*new\$1owner*
El nuevo propietario de la plantilla.
ADD *parameter* [AS] [*value*]
Añade un nuevo parámetro a la plantilla.
+ Para los parámetros que solo admiten palabras clave (como CSV o GZIP), especifique únicamente el nombre del parámetro.
+ Para los parámetros que requieren valores, especifique el nombre del parámetro seguido del valor. Si lo desea, puede incluir AS entre el parámetro y el valor.
DROP *parameter*
Quita el parámetro especificado de la plantilla. No se pueden eliminar varios parámetros con un solo comando DROP.
SET *parameter* TO *value1* [, *parameter2* TO *value2* , …]
Actualiza los valores de los parámetros de plantilla existentes. Úselo solo para los parámetros que ya tienen valores. Se pueden actualizar varios parámetros en un mismo comando.
## Ejemplos
En el siguiente ejemplo, se cambia el nombre de la plantilla test\$1template a demo\$1template.
```
ALTER TEMPLATE test_template
RENAME TO demo_template;
```
En el siguiente ejemplo se otorga la propiedad del esquema demo\$1template al usuario bob.
```
ALTER TEMPLATE demo_template
OWNER TO bob;
```
En el siguiente ejemplo se agrega un parámetro `CSV` a la plantilla demo\$1template.
```
ALTER TEMPLATE demo_template
ADD CSV;
```
En el siguiente ejemplo se agrega un parámetro `TIMEFORMAT 'auto'` a la plantilla demo\$1template.
```
ALTER TEMPLATE demo_template
ADD TIMEFORMAT 'auto';
```
En el siguiente ejemplo se elimina el parámetro `ENCRYPTED` de la plantilla demo\$1template.
```
ALTER TEMPLATE demo_template
DROP ENCRYPTED;
```
En el siguiente ejemplo, se establece el parámetro `DELIMITER` en `'|'` y el parámetro `TIMEFORMAT` en `'epochsecs'`:
```
ALTER TEMPLATE demo_template
SET DELIMITER TO '|', TIMEFORMAT TO 'epochsecs';
```
# ALTER USER
Cambia un usuario de base de datos.
## Privilegios necesarios
Los siguientes privilegios son necesarios para ALTER USER:
+ Superusuario
+ Usuarios con el privilegio ALTER USER
+ Usuario actual que desea cambiar su propia contraseña
## Sintaxis
```
ALTER USER username [ WITH ] option [, ... ]
where option is
CREATEDB | NOCREATEDB
| CREATEUSER | NOCREATEUSER
| SYSLOG ACCESS { RESTRICTED | UNRESTRICTED }
| PASSWORD { 'password' | 'md5hash' | 'sha256hash' | DISABLE }
[ VALID UNTIL 'expiration_date' ]
| RENAME TO new_name |
| CONNECTION LIMIT { limit | UNLIMITED }
| SESSION TIMEOUT limit | RESET SESSION TIMEOUT
| SET parameter { TO | = } { value | DEFAULT }
| RESET parameter
| EXTERNALID external_id
```
## Parameters
*username*
Nombre del usuario.
WITH
Palabra clave opcional.
CREATEDB \$1 NOCREATEDB
La opción CREATEDB permite que el usuario cree nuevas bases de datos. NOCREATEDB es el valor predeterminado.
CREATEUSER \$1 NOCREATEUSER
La opción CREATEUSER crea un superusuario con todos los privilegios de base de datos, incluido CREATE USER. El valor predeterminado es NOCREATEUSER. Para obtener más información, consulte [Superusuarios](r_superusers.md).
SYSLOG ACCESS \$1 RESTRICTED \$1 UNRESTRICTED \$1
Se trata de una cláusula que especifica el nivel de acceso a las vistas y las tablas de sistema de Amazon Redshift que tiene el usuario.
Los usuarios normales que tengan el permiso SYSLOG ACCESS RESTRICTED solo pueden ver las filas generadas por ese usuario en las tablas y vistas del sistema visibles para el usuario. El valor predeterminado es RESTRICTED.
Los usuarios normales que tengan el permiso SYSLOG ACCESS UNRESTRICTED pueden ver todas las filas en las tablas y vistas del sistema visibles para el usuario, incluidas las filas generadas por otro usuario. UNRESTRICTED no permite que los usuarios normales puedan obtener acceso a las tablas visibles para los superusuarios. Solo los superusuarios pueden ver estas tablas.
Al brindar a un usuario acceso sin restricciones a las tablas del sistema, le proporciona la visibilidad necesaria para ver los datos generados por otros usuarios. Por ejemplo, STL\$1QUERY y STL\$1QUERYTEXT contienen todo el texto de las instrucciones INSERT, UPDATE y DELETE, que podrían incluir datos confidenciales generados por los usuarios.
Todas las filas de SVV\$1TRANSACTIONS son visibles para todos los usuarios.
Para obtener más información, consulte [Visibilidad de datos en las tablas y vistas de sistema](cm_chap_system-tables.md#c_visibility-of-data).
PASSWORD \$1 '*password*' \$1 '*md5hash*' \$1 '*sha256hash*' \$1 DISABLE \$1
Establece la contraseña del usuario.
De manera predeterminada, los usuarios pueden cambiar sus propias contraseñas, a menos que la contraseña esté deshabilitada. Para deshabilitar la contraseña de un usuario, especifique DISABLE. Cuando se deshabilita la contraseña de un usuario, se elimina del sistema y el usuario solo puede iniciar sesión con credenciales de usuario de AWS Identity and Access Management IAM temporales. Para obtener más información, consulte [Uso de la autenticación de IAM para generar credenciales de usuario de base de datos](https://docs.aws.amazon.com/redshift/latest/mgmt/generating-user-credentials.html). Solo un superusuario puede habilitar o deshabilitar contraseñas. No puede deshabilitar la contraseña de un superusuario. Para habilitar una contraseña, ejecute ALTER USER y especifique una contraseña.
Para obtener información acerca de cómo utilizar el parámetro PASSWORD, consulte [CREATE USER](r_CREATE_USER.md).
VALID UNTIL '*expiration\$1date*'
Especifica que la contraseña tiene una fecha de vencimiento. Use el valor `'infinity'` para evitar tener una fecha de vencimiento. El tipo de datos válido para este parámetro es timestamp (marca temporal).
Solo los superusuarios pueden utilizar este parámetro.
RENAME TO
Cambia el nombre del usuario.
*new\$1name*
Nuevo nombre de usuario. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
Cuando cambia el nombre de un usuario, también debe restablecer la contraseña del usuario. La contraseña de restablecimiento no tiene por qué ser diferente de la contraseña anterior. Debido a que el nombre del usuario se utiliza como parte del cifrado de la contraseña, la contraseña se borra cada vez que se cambia el nombre de un usuario. El usuario no podrá iniciar sesión hasta que no se haya restablecido la contraseña. Por ejemplo:
```
alter user newuser password 'EXAMPLENewPassword11';
```
CONNECTION LIMIT \$1 *limit* \$1 UNLIMITED \$1
La cantidad máxima de conexiones a la base de datos que el usuario puede tener abiertas al mismo tiempo. Este límite no se aplica a los superusuarios. Use la palabra clave UNLIMITED para permitir la cantidad máxima de conexiones simultáneas. También puede aplicar un límite en la cantidad de conexiones de cada base de datos. Para obtener más información, consulte [CREATE DATABASE](r_CREATE_DATABASE.md). El valor predeterminado es UNLIMITED. Para ver las conexiones actuales, consulte la vista del sistema [STV\$1SESSIONS](r_STV_SESSIONS.md).
Si se aplican los límites de conexión tanto para usuarios como para bases de datos, debe haber una ranura de conexión sin utilizar disponible dentro de ambos límites cuando un usuario intenta conectarse.
SESSION TIMEOUT *limit* \$1 RESET SESSION TIMEOUT
El tiempo máximo en segundos durante el cual una sesión permanece inactiva o en reposo. El rango es de 60 segundos (un minuto) a 1 728 000 segundos (20 días). Si no se establece el tiempo de espera de la sesión para el usuario, se aplica el ajuste del clúster. Para obtener más información, consulte [Cuotas y límites de Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-limits.html) en la *Guía de administración de Amazon Redshift*.
Cuando se establece el tiempo de espera de la sesión, se aplica solo a las sesiones nuevas.
Para ver información sobre las sesiones de usuario activas, incluidos la hora de inicio, el nombre de usuario y el tiempo de espera de la sesión, consulte la vista de sistema [STV\$1SESSIONS](r_STV_SESSIONS.md). Para ver información sobre el historial de sesiones del usuario, consulte la vista [STL\$1SESSIONS](r_STL_SESSIONS.md). Para recuperar información acerca de los usuarios de las bases de datos, incluidos los valores de tiempo de espera de la sesión, consulte la vista [SVL\$1USER\$1INFO](r_SVL_USER_INFO.md).
SET
Establece un parámetro de configuración a un nuevo valor predeterminado para todas las sesiones ejecutadas por el usuario especificado.
RESET
Restablece un parámetro de configuración al valor predeterminado original para el usuario especificado.
*parameter*
Nombre del parámetro que se debe establecer o restablecer.
*valor de*
Valor nuevo del parámetro.
DEFAULT
Establece el parámetro de configuración al valor predeterminado para todas las sesiones ejecutadas por el usuario especificado.
EXTERNALID *external\$1id*
El identificador del usuario, que está asociado a un proveedor de identidades. El usuario debe tener desactivada la contraseña. Para obtener más información, consulte [Federación de proveedores de identidades (IdP) nativos para Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-native-idp.html).
## Notas de uso
+ **Intento de modificar rdsdb**: no puede modificar al usuario denominado `rdsdb`.
+ **Creación de una contraseña desconocida**: cuando use la autenticación de AWS Identity and Access Management (IAM) para crear credenciales de usuario de la base de datos, es posible que quiera crear un superusuario que solo pueda iniciar sesión con credenciales temporales. Puede deshabilitar la contraseña de un superusuario, pero no puede crear una contraseña desconocida mediante una cadena hash MD5 generada aleatoriamente.
```
alter user iam_superuser password 'md51234567890123456780123456789012';
```
+ **Configuración de search\$1path**: cuando establece el parámetro [search\$1path](r_search_path.md) con el comando ALTER USER, la modificación entra en vigor en el próximo inicio de sesión del usuario especificado. Si desea cambiar el valor search\$1path para la sesión y el usuario actuales, utilice un comando SET.
+ **Configuración de la zona horaria**: cuando utilice ESTABLECER ZONA HORARIA con el comando ALTER USER, la modificación entra en vigor en el próximo inicio de sesión del usuario especificado.
+ **Trabajo con políticas de seguridad a nivel de fila y enmascaramiento de datos dinámico**: cuando el clúster o espacio de nombres sin servidor aprovisionado tiene políticas de enmascaramiento de datos dinámico o de seguridad en el nivel de fila, los siguientes comandos están bloqueados para los usuarios habituales:
```
ALTER SET enable_case_sensitive_super_attribute/enable_case_sensitive_identifier/downcase_delimited_identifier
```
Solo los superusuarios y los usuarios con el privilegio ALTER USER pueden establecer estas opciones de configuración. Para obtener información sobre seguridad de nivel de fila, consulte [Seguridad de nivel básico](t_rls.md). Para obtener información sobre el enmascaramiento dinámico de datos, consulte [Enmascaramiento de datos dinámico](t_ddm.md).
## Ejemplos
En el siguiente ejemplo, se le otorga al usuario ADMIN el privilegio de crear bases de datos:
```
alter user admin createdb;
```
En el siguiente ejemplo, se establece la contraseña del usuario ADMIN a `adminPass9` y se establece una fecha y hora de vencimiento para la contraseña:
```
alter user admin password 'adminPass9'
valid until '2017-12-31 23:59';
```
En el siguiente ejemplo, se cambia el nombre del usuario ADMIN a SYSADMIN:
```
alter user admin rename to sysadmin;
```
En el siguiente ejemplo, se actualiza el tiempo de espera de la sesión inactiva para un usuario a 300 segundos.
```
ALTER USER dbuser SESSION TIMEOUT 300;
```
Restablece el tiempo de espera de la sesión inactiva del usuario. Cuando lo restablece, se aplica el ajuste del clúster. Debe ser un superusuario de base de datos para ejecutar este comando. Para obtener más información, consulte [Cuotas y límites de Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-limits.html) en la *Guía de administración de Amazon Redshift*.
```
ALTER USER dbuser RESET SESSION TIMEOUT;
```
En el ejemplo siguiente se actualiza el ID externo de un usuario denominado `bob`. El espacio de nombres es `myco_aad`. Si el espacio de nombres no está asociado a un proveedor de identidades registrado, se produce un error.
```
ALTER USER myco_aad:bob EXTERNALID "ABC123" PASSWORD DISABLE;
```
En el siguiente ejemplo se establece la zona horaria para todas las sesiones ejecutadas por un usuario específico de la base de datos. Cambia la zona horaria para las sesiones posteriores, pero no para la actual.
```
ALTER USER odie SET TIMEZONE TO 'Europe/Zurich';
```
En el siguiente ejemplo, se establece el número máximo de conexiones a bases de datos que el usuario `bob` puede tener abiertas.
```
ALTER USER bob CONNECTION LIMIT 10;
```
# ANALYZE
Actualiza las estadísticas de la tabla para que el planificador de consultas las utilice.
## Privilegios necesarios
Los siguientes privilegios son necesarios para ANALYZE:
+ Superusuario
+ Usuarios con el privilegio ANALYZE
+ Propietario de la relación
+ Propietario de la base de datos con quien se comparte la tabla
## Sintaxis
```
ANALYZE [ VERBOSE ]
[ [ table_name [ ( column_name [, ...] ) ] ]
[ PREDICATE COLUMNS | ALL COLUMNS ]
```
## Parameters
VERBOSE
Una cláusula que devuelve mensajes de información de progreso acerca de la operación ANALYZE. Esta opción es útil cuando no se especifica una tabla.
*table\$1name*
Puede analizar tablas específicas, incluidas tablas temporales. Puede completar la tabla con el nombre de su esquema. Si lo desea, puede especificar un table\$1name para analizar una única tabla. No puede especificar más de un *table\$1name (nombre\$1de\$1tabla)* con una única instrucción ANALYZE *table\$1name (nombre\$1de\$1tabla)*. Si no se especifica un valor *table\$1name*, se analizan todas las tablas de la base de datos actualmente conectada, incluidas las tablas persistentes en el catálogo del sistema. Amazon Redshift omite el análisis de una tabla si el porcentaje de filas que se han modificado desde la última operación ANALYZE es inferior al límite de análisis. Para obtener más información, consulte [Umbral de análisis](#r_ANALYZE-threshold).
No necesita analizar las tablas de sistema de Amazon Redshift (tablas STL y STV).
*column\$1name*
Si especifica un valor *table\$1name (nombre\$1de\$1tabla)*, también puede especificar una o varias columnas de la tabla (como una lista de valores separados por columnas entre paréntesis). Si se especifica una lista de columnas, solo se analizarán las columnas que aparecen en la lista.
PREDICATE COLUMNS \$1 ALL COLUMNS
Se trata de cláusulas que indican si ANALYZE debe incluir solo columnas de predicados. Especifique PREDICATE COLUMNS para analizar solamente las columnas utilizadas como predicados en consultas anteriores o que sean posibles candidatas para utilizarse como predicados. Especifique ALL COLUMNS para analizar todas las columnas. El valor predeterminado es ALL COLUMNS.
Se incluye una columna en el conjunto de columnas de predicados si cualquiera de los siguientes es verdadero:
+ La columna ha sido utilizada en una consulta como parte de un filtro, una condición de combinación o una cláusula de agrupación.
+ La columna es una clave de distribución.
+ La columna forma parte de una clave de ordenación.
Si no se marca ninguna columna como columna de predicado, por ejemplo porque la tabla aún no se ha consultado, se analizan todas las columnas incluso si PREDICATE COLUMNS está especificado. Cuando esto sucede, Amazon Redshift podría responder con un mensaje similar a No se han encontrado columnas de predicado para “*nombre-de-tabla*”. Analizando todas las columnas. Para obtener más información acerca de las columnas de predicados, consulte [Análisis de tablas](t_Analyzing_tables.md).
## Notas de uso
Amazon Redshift ejecuta ANALYZE de manera automática en las tablas que usted crea con los siguientes comandos:
+ CREATE TABLE AS
+ CREATE TEMP TABLE AS
+ SELECT INTO
No puede analizar una tabla externa.
No es necesario ejecutar el comando ANALYZE en estas tablas cuando se crean por primera vez. Si las modifica, debe analizarlas de la misma manera en que analiza las demás tablas.
### Umbral de análisis
Para reducir el tiempo de procesamiento y mejorar el rendimiento general del sistema, Amazon Redshift omite la operación ANALYZE en una tabla si el porcentaje de filas que se han modificado desde que se ejecutó el comando ANALYZE por última vez es inferior al límite de análisis especificado por el parámetro [analyze\$1threshold\$1percent](r_analyze_threshold_percent.md). Por defecto, `analyze_threshold_percent` es 10. Si desea cambiar `analyze_threshold_percent` para la sesión actual, ejecute el comando [SET](r_SET.md). En el siguiente ejemplo, se cambia `analyze_threshold_percent` a 20 por ciento.
```
set analyze_threshold_percent to 20;
```
Para analizar las tablas cuando solo han cambiado unas pocas filas, establezca `analyze_threshold_percent` en un número pequeño elegido arbitrariamente. Por ejemplo, si establece `analyze_threshold_percent` como 0,01, las tablas con 100 000 000 filas no se omitirán si se han modificado al menos 10 000 filas.
```
set analyze_threshold_percent to 0.01;
```
Si ANALYZE omite una tabla porque no cumple con el umbral de análisis, Amazon Redshift devuelve el siguiente mensaje.
```
ANALYZE SKIP
```
Para analizar todas las tablas, aunque no haya cambiado ninguna fila, establezca `analyze_threshold_percent` en 0.
Para ver los resultados de las operaciones ANALYZE, consulte la tabla del sistema [STL\$1ANALYZE](r_STL_ANALYZE.md).
Para obtener más información acerca del análisis de tablas, consulte [Análisis de tablas](t_Analyzing_tables.md).
## Ejemplos
Analiza todas las tablas de la base de datos TICKIT y devolver la información de progreso.
```
analyze verbose;
```
Analiza solo la tabla LISTING.
```
analyze listing;
```
Analiza las columnas VENUEID y VENUENAME de la tabla VENUE.
```
analyze venue(venueid, venuename);
```
Analiza solo columnas de predicado de la tabla VENUE.
```
analyze venue predicate columns;
```
# ANALYZE COMPRESSION
Realiza un análisis de compresión y produce un informe con la codificación de compresión sugerida para las tablas analizadas. Para cada columna, el informe incluye un cálculo de la reducción potencial de espacio en disco en comparación con la codificación RAW.
## Sintaxis
```
ANALYZE COMPRESSION
[ [ table_name ]
[ ( column_name [, ...] ) ] ]
[COMPROWS numrows]
```
## Parameters
*table\$1name*
Puede analizar la compresión para tablas específicas, incluidas tablas temporales. Puede completar la tabla con el nombre de su esquema. Si lo desea, puede especificar un *table\$1name (nombre\$1de\$1tabla)* para analizar una única tabla. Si no especifica *table\$1name (nombre\$1de\$1tabla)*, se analizarán todas las tablas de la base de datos que está conectada actualmente. No puede especificar varios valores *table\$1name (nombre\$1de\$1tabla)* con una única instrucción ANALYZE COMPRESSION.
*column\$1name*
Si especifica un valor *table\$1name (nombre\$1de\$1tabla)*, también puede especificar una o varias columnas de la tabla (como una lista de valores separados por columnas entre paréntesis).
COMPROWS
Cantidad de filas que se usarán como el tamaño de muestra para el análisis de compresión. El análisis se ejecuta sobre las filas de cada sector de datos. Por ejemplo, si especifica COMPROWS 1000000 (1 000 000) y el sistema contiene 4 sectores totales, no se leen y analizan más de 250 000 filas por sector. Si no especifica COMPROWS, el tamaño de muestra se establecerá de manera predeterminada en 100 000 por sector. Los valores de COMPROWS inferiores al valor predeterminado de 100 000 filas por sector se actualizan automáticamente al valor predeterminado. No obstante, el análisis de compresión no produce recomendaciones si la cantidad de datos de la tabla no alcanza para producir una muestra significativa. Si el número de COMPROWS es superior a la cantidad de filas de la tabla, el comando ANALYZE COMPRESSION avanza y ejecuta el análisis de compresión contra todas las filas disponibles El uso de COMPROWS produce un error si no se especifica una tabla.
*numrows*
Cantidad de filas que se usarán como el tamaño de muestra para el análisis de compresión. El rango aceptado para *numrows (número\$1de\$1filas)* es un número comprendido entre 1000 y 1000000000 (1 000 000 000).
## Notas de uso
ANALYZE COMPRESSION adquiere un bloqueo de tabla exclusivo, que previene lecturas y escrituras concurrentes en la tabla. Ejecute solo el comando ANALYZE COMPRESSION cuando la tabla esté inactiva.
Ejecute ANALYZE COMPRESSION para obtener recomendaciones para esquemas de codificación de columna, según una muestra del contenido de la tabla. ANALYZE COMPRESSION es una herramienta de consultoría y no modifica las codificaciones de columna de la tabla. Puede aplicar la codificación sugerida creando de nuevo la tabla o generando una nueva tabla con el mismo esquema. El espacio en disco se puede reducir significativamente creando de nuevo una tabla sin comprimir con los esquemas de codificación adecuados. Este enfoque ahorra espacio en disco y mejora el rendimiento de las consultas en las cargas de trabajo relacionadas con operaciones de E/S.
ANALYZE COMPRESSION omite la verdadera fase de análisis y devuelve directamente el tipo de codificación original de cualquier columna que se haya designado como SORTKEY. Esto se debe a que los análisis restringidos por rango pueden funcionar mal cuando las columnas SORTKEY están mucho más comprimidas que otras columnas.
## Ejemplos
En el siguiente ejemplo, se muestran la codificación y la reducción porcentual estimada para las columnas de la tabla LISTING únicamente:
```
analyze compression listing;
Table | Column | Encoding | Est_reduction_pct
---------+----------------+----------+-------------------
listing | listid | az64 | 40.96
listing | sellerid | az64 | 46.92
listing | eventid | az64 | 53.37
listing | dateid | raw | 0.00
listing | numtickets | az64 | 65.66
listing | priceperticket | az64 | 72.94
listing | totalprice | az64 | 68.05
listing | listtime | az64 | 49.74
```
En el siguiente ejemplo, se analizan las columnas QTYSOLD, COMMISSION y SALETIME de la tabla SALES.
```
analyze compression sales(qtysold, commission, saletime);
Table | Column | Encoding | Est_reduction_pct
-------+------------+----------+-------------------
sales | salesid | N/A | 0.00
sales | listid | N/A | 0.00
sales | sellerid | N/A | 0.00
sales | buyerid | N/A | 0.00
sales | eventid | N/A | 0.00
sales | dateid | N/A | 0.00
sales | qtysold | az64 | 83.06
sales | pricepaid | N/A | 0.00
sales | commission | az64 | 71.85
sales | saletime | az64 | 49.63
```
# ATTACH MASKING POLICY
Adjunta una política de enmascaramiento dinámico de datos existente a una columna. Para obtener más información sobre el enmascaramiento dinámico de datos, consulte [Enmascaramiento de datos dinámico](t_ddm.md).
Los superusuarios y los usuarios o roles que tengan el rol sys:secadmin pueden adjuntar una política de enmascaramiento.
## Sintaxis
```
ATTACH MASKING POLICY
{
policy_name ON relation_name
| database_name.policy_name ON database_name.schema_name.relation_name
}
( { output_column_names | output_path } )
[ USING ( { input_column_names | input_path } ) ]
TO { user_name | ROLE role_name | PUBLIC }
[ PRIORITY priority ];
```
## Parameters
*policy\$1name*
El nombre de la política de enmascaramiento que se va a adjuntar.
database\$1name
El nombre de la base de datos a partir de la que se crea la política y la relación. La política y la relación deben estar en la misma base de datos. La base de datos puede ser la base de datos conectada o una base de datos que admita los permisos federados de Amazon Redshift.
schema\$1name
El nombre del esquema al que pertenece la relación.
*relation\$1name*
Es el nombre de la relación a la que se asociará la política de enmascaramiento.
*output\$1column\$1names*
Los nombres de las columnas a las que se aplicará la política de enmascaramiento.
*output\$1paths*
Es la ruta completa del objeto SUPER al que se aplicará la política de enmascaramiento, incluido el nombre de la columna. Por ejemplo, para una relación con una columna de tipo SUPER llamada `person`, *output\$1path* podría ser `person.name.first_name`.
*input\$1column\$1names*
Los nombres de las columnas que la política de enmascaramiento tomará como entrada. Este parámetro es opcional. Si no se especifica, la política de enmascaramiento utiliza *output\$1column\$1names* como entradas.
*input\$1paths*
Es la ruta completa del objeto SUPER que la política de enmascaramiento tomará como entrada. Este parámetro es opcional. Si no se especifica, la política de enmascaramiento utiliza *output\$1path* como entradas.
*user\$1name*
El nombre del usuario al que se adjuntará la política de enmascaramiento. No puede adjuntar dos políticas a la misma combinación de usuario y columna o rol y columna. Puede adjuntar una política a un usuario y otra al rol del usuario. En este caso, se aplica la política de mayor prioridad.
Solo puede establecer user\$1name, role\$1name o PUBLIC en un solo comando ATTACH MASKING POLICY.
*role\$1name*
El nombre del rol al que se adjuntará la política de enmascaramiento. No puede adjuntar dos políticas al mismo par de columna-rol. Puede adjuntar una política a un usuario y otra política al rol del usuario. En este caso, se aplica la política de mayor prioridad.
Solo puede establecer user\$1name, role\$1name o PUBLIC en un solo comando ATTACH MASKING POLICY.
*PUBLIC*
Adjunta la política de enmascaramiento a todos los usuarios que acceden a la tabla. Para que se apliquen, debe dar a otras políticas de enmascaramiento adjuntas a pares de columna-usuario o columna-rol específicos una prioridad mayor que a la política PUBLIC.
Solo puede establecer user\$1name, role\$1name o PUBLIC en un solo comando ATTACH MASKING POLICY.
*priority*
Prioridad de la política de enmascaramiento. Cuando se aplican varias políticas de enmascaramiento a la consulta de un usuario determinado, se aplica la de mayor prioridad.
No puede asociar dos políticas diferentes a la misma columna con la misma prioridad, incluso si las dos políticas están asociadas a usuarios o roles diferentes. Puede asociar la misma política varias veces al mismo conjunto de parámetros de tabla, columna de salida, columna de entrada y prioridad, siempre que el usuario o rol al que se asocie la política sea diferente cada vez.
No puede aplicar una política a una columna con la misma prioridad que otra política adjunta a esa columna, aunque sean para roles diferentes. Este campo es opcional. Si no especifica una prioridad, la política de enmascaramiento establece de forma predeterminada una prioridad de 0.
Para obtener información sobre el uso de ATTACH MASKING POLICY en el catálogo de permisos federados de Amazon Redshift, consulte [Administración del control de acceso en el catálogo de permisos federados de Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/dg/federated-permissions-managing-access.html).
# ATTACH RLS POLICY
Adjunte una política de seguridad de la fila en una tabla a uno o más usuarios o roles.
Los superusuarios y los usuarios o roles que tienen el rol `sys:secadmin` puede adjuntar una política.
## Sintaxis
```
ATTACH RLS POLICY
{
policy_name ON [TABLE] table_name [, ...]
| database_name.policy_name ON [TABLE] database_name.schema_name.table_name [, ...]
}
TO { user_name | ROLE role_name | PUBLIC } [, ...]
```
## Parameters
*policy\$1name*
El nombre de la política.
database\$1name
El nombre de la base de datos a partir de la que se crea la política y la relación. La política y la relación deben estar en la misma base de datos. La base de datos puede ser la base de datos conectada o una base de datos que admita los permisos federados de Amazon Redshift.
schema\$1name
El nombre del esquema al que pertenece la relación.
table\$1name
Es la relación a la que se asocia la política de seguridad de nivel de fila.
TO \$1 *user\$1name* \$1 ROLE *role\$1name* \$1 PUBLIC\$1 [, ...]
Especifica si la política se adjunta a uno o varios usuarios o roles especificados.
Para obtener información sobre el uso de ATTACH RLS POLICY en el catálogo de permisos federados de Amazon Redshift, consulte [Administración del control de acceso en el catálogo de permisos federados de Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/dg/federated-permissions-managing-access.html).
## Notas de uso
Al trabajar con la instrucción ATTACH RLS POLICY, observe lo siguiente:
+ La tabla que se adjunta debe tener todas las columnas enumeradas en la cláusula WITH de la instrucción de creación de políticas.
+ Amazon Redshift RLS no permite asociar políticas de RLS a los siguientes objetos:
+ Tablas
+ Vistas
+ Vistas de enlace en tiempo de ejecución
+ Vistas materializadas
+ Amazon Redshift RLS no permite asociar políticas de RLS a los siguientes objetos:
+ Tablas de catálogo
+ Relaciones entre bases de datos
+ tablas externas
+ Tablas temporales
+ Tablas de búsqueda de políticas
+ Tablas básicas de vistas materializadas
+ Las políticas de RLS que se asocian a los superusuarios o a los usuarios con el permiso `sys:secadmin` se omiten.
## Ejemplos
En el siguiente ejemplo, se adjunta una política de RLS a las combinaciones de tablas y roles especificadas. La política de RLS se aplica a los usuarios con el rol de `analyst` o `dbadmin` cuando acceden a la tabla tickit\$1category\$1redshift.
```
ATTACH RLS POLICY policy_concerts ON tickit_category_redshift TO ROLE analyst, ROLE dbadmin;
```
# BEGIN
Inicia una transacción. Sinónimo de START TRANSACTION.
Una transacción es una única unidad lógica de trabajo, independientemente de tener un comando o varios comandos. Por lo general, todos los comandos de una transacción se ejecutan en una instantánea de la base de datos cuya hora de inicio se determina con el valor establecido para el parámetro de configuración del sistema `transaction_snapshot_begin`.
De manera predeterminada, las operaciones individuales de Amazon Redshift (consultas, instrucciones DDL, cargas) se confirman de manera automática en la base de datos. Si desea suspender la confirmación de una operación hasta que se complete el trabajo subsiguiente, necesita abrir una transacción con la instrucción BEGIN, luego ejecutar los comandos requeridos y cerrar la transacción con una instrucción [COMMIT](r_COMMIT.md) o [END](r_END.md). Si es necesario, puede utilizar una instrucción [ROLLBACK](r_ROLLBACK.md) para detener una transacción en curso. Una excepción a este comportamiento es el comando [TRUNCATE](r_TRUNCATE.md), que confirma la transacción en la que se ejecuta y no puede revertirse.
## Sintaxis
```
BEGIN [ WORK | TRANSACTION ] [ ISOLATION LEVEL option ] [ READ WRITE | READ ONLY ]
START TRANSACTION [ ISOLATION LEVEL option ] [ READ WRITE | READ ONLY ]
Where option is
SERIALIZABLE
| READ UNCOMMITTED
| READ COMMITTED
| REPEATABLE READ
Note: READ UNCOMMITTED, READ COMMITTED, and REPEATABLE READ have no
operational impact and map to SERIALIZABLE in Amazon Redshift. You can see database isolation levels on your cluster
by querying the stv_db_isolation_level table.
```
## Parameters
WORK
Palabra clave opcional.
TRANSACTION
Palabra clave opcional; WORK y TRANSACTION son sinónimos.
ISOLATION LEVEL SERIALIZABLE
El aislamiento serializable es compatible de manera predeterminada, por lo que el comportamiento de la transacción es el mismo si la sintaxis está incluida o no en la instrucción. Para obtener más información, consulte [Administración de operaciones de escritura simultáneas](c_Concurrent_writes.md). No se admite otro nivel de aislamiento.
El estándar de SQL define cuatro niveles de aislamiento de transacciones para prevenir *lecturas sucias* (donde una transacción lee los datos escritos por una transacción paralela sin confirmar), *lecturas no repetibles* (donde una transacción relee datos que leyó anteriormente y descubre que otra transacción que se confirmó después de la lectura inicial modificó los datos) y *lecturas fantasmas* (donde una transacción vuelve a ejecutar una consulta, devuelve un conjunto de filas que cumplen una condición de búsqueda y luego descubre que el conjunto de filas ha cambiado debido a otra transacción recientemente confirmada):
+ Lectura sin confirmar: las lecturas sucias, lecturas no repetibles y lecturas fantasmas son posibles.
+ Lectura confirmada: las lecturas no repetibles y lecturas fantasmas son posibles.
+ Lectura repetible: las lecturas fantasmas son posibles.
+ Serializable: previene lecturas sucias, lecturas no repetibles y lecturas fantasmas.
Aunque puede utilizar cualquiera de los cuatro niveles de aislamiento de las transacciones, Amazon Redshift procesa todos los niveles de aislamiento como serializables.
READ WRITE
Le otorga a la transacción permisos de lectura y escritura.
READ ONLY
Le otorga a la transacción permisos de solo lectura.
## Ejemplos
En el siguiente ejemplo, se inicia un bloque de transacción serializable:
```
begin;
```
En el siguiente ejemplo, se inicia el bloque de transacción con un nivel de aislamiento serializable y permisos de lectura y escritura:
```
begin read write;
```
# CALL
Ejecuta un procedimiento almacenado. El comando CALL debe incluir el nombre del procedimiento y los valores del argumento de entrada. Debe llamar a un procedimiento almacenado mediante la instrucción CALL.
**nota**
CALL no puede formar parte de ninguna consultar normal.
## Sintaxis
```
CALL sp_name ( [ argument ] [, ...] )
```
## Parameters
*sp\$1name*
El nombre del procedimiento que debe ejecutarse.
*argumento*
El valor del argumento de entrada. Este parámetro también puede ser un nombre de función; por ejemplo `pg_last_query_id()`. No es posible utilizar consultas como argumentos de CALL.
## Notas de uso
Los procedimientos almacenados de Amazon Redshift admiten llamadas anidadas y recursivas, tal y como se describe a continuación. Además, asegúrese de que el soporte de los controladores está al día, también se describe a continuación.
**Topics**
+ [Llamadas anidadas](#r_CALL_procedure-nested-calls)
+ [Soporte de los controladores](#r_CALL_procedure-driver-support)
### Llamadas anidadas
Los procedimientos almacenados de Amazon Redshift admiten llamadas anidadas y recursivas. El número máximo de niveles de agrupación permitido es 16. Las llamadas agrupadas pueden encapsular la lógica empresarial en procedimientos más pequeños que pueden compartir varios remitentes.
Si llama a un procedimiento agrupado que tiene parámetros de salida, el procedimiento interior debe definir argumentos INOUT. En este caso, el procedimiento interior se pasa en una variable no constante. No se permiten argumentos OUT. Este comportamiento se produce porque se necesita una variable para retener la salida de la llamada interior.
La relación entre los procedimientos interior y exterior se registra en la columna `from_sp_call` de [SVL\$1STORED\$1PROC\$1CALL](r_SVL_STORED_PROC_CALL.md).
El siguiente ejemplo muestra el paso de variable a una llamada de procedimientos agrupada a través de argumentos INOUT.
```
CREATE OR REPLACE PROCEDURE inner_proc(INOUT a int, b int, INOUT c int) LANGUAGE plpgsql
AS $$
BEGIN
a := b * a;
c := b * c;
END;
$$;
CREATE OR REPLACE PROCEDURE outer_proc(multiplier int) LANGUAGE plpgsql
AS $$
DECLARE
x int := 3;
y int := 4;
BEGIN
DROP TABLE IF EXISTS test_tbl;
CREATE TEMP TABLE test_tbl(a int, b varchar(256));
CALL inner_proc(x, multiplier, y);
insert into test_tbl values (x, y::varchar);
END;
$$;
CALL outer_proc(5);
SELECT * from test_tbl;
a | b
----+----
15 | 20
(1 row)
```
### Soporte de los controladores
Recomendamos actualizar los controladores Java Database Connectivity (JDBC) y Open Database Connectivity (ODBC) a la versión más reciente compatible con los procedimientos almacenados de Amazon Redshift.
Es posible que pueda utilizar el controlador existente si la herramienta de su cliente utiliza operaciones de la API del controlador que pasa a través de la instrucción CALL al servidor. Los parámetros de salida, si los hubiere, se devuelven como un conjunto de resultados de una fila.
Las versiones más recientes de los controladores de JDBC y ODBC de Amazon Redshift admiten los metadatos para el descubrimiento de procedimientos almacenados. También tienen soporte `CallableStatement` para aplicaciones Java personalizadas. Para obtener más información acerca de los controladores, consulte [Conexión a un clúster de Amazon Redshift mediante herramientas de cliente SQL](https://docs.aws.amazon.com/redshift/latest/mgmt/connecting-to-cluster.html) en la *Guía de administración de Amazon Redshift.*
Los siguientes ejemplos muestran cómo usar diferentes operaciones de la API del controlador JDBC para llamadas de procedimientos almacenadas.
```
void statement_example(Connection conn) throws SQLException {
statement.execute("CALL sp_statement_example(1)");
}
void prepared_statement_example(Connection conn) throws SQLException {
String sql = "CALL sp_prepared_statement_example(42, 84)";
PreparedStatement pstmt = conn.prepareStatement(sql);
pstmt.execute();
}
void callable_statement_example(Connection conn) throws SQLException {
CallableStatement cstmt = conn.prepareCall("CALL sp_create_out_in(?,?)");
cstmt.registerOutParameter(1, java.sql.Types.INTEGER);
cstmt.setInt(2, 42);
cstmt.executeQuery();
Integer out_value = cstmt.getInt(1);
}
```
## Ejemplos
En el siguiente ejemplo, se llama al nombre del procedimiento `test_spl`.
```
call test_sp1(3,'book');
INFO: Table "tmp_tbl" does not exist and will be skipped
INFO: min_val = 3, f2 = book
```
En el siguiente ejemplo, se llama al nombre del procedimiento `test_spl2`.
```
call test_sp2(2,'2019');
f2 | column2
---------------------+---------
2019+2019+2019+2019 | 2
(1 row)
```
# CANCEL
Cancela una consulta de base de datos que está actualmente en ejecución.
El comando CANCEL requiere el ID de proceso o el ID de sesión de la consulta en ejecución y muestra un mensaje de confirmación para verificar que se canceló la consulta.
## Privilegios necesarios
Los siguientes privilegios son necesarios para CANCEL:
+ Superusuario que cancela su propia consulta
+ Superusuario que cancela la consulta de un usuario
+ Usuarios con el privilegio CANCEL que cancelan la consulta de un usuario
+ Usuario que cancela su propia consulta
## Sintaxis
```
CANCEL process_id [ 'message' ]
```
## Parameters
*process\$1id*
Para cancelar una consulta que se esté ejecutando en un clúster de Amazon Redshift, utilice el `pid` (ID de proceso) de [STV\$1RECENTS](r_STV_RECENTS.md) que corresponda a la consulta que desee cancelar.
Para cancelar una consulta que se esté ejecutando en un grupo de trabajo de Amazon Redshift sin servidor, utilice el `session_id` de [SYS\$1QUERY\$1HISTORY](SYS_QUERY_HISTORY.md) que corresponda a la consulta que desee cancelar.
'*message*'
Un mensaje de confirmación opcional que se muestra cuando se completa la cancelación de la consulta. Si no especifica un mensaje, Amazon Redshift mostrará el mensaje predeterminado como verificación. Debe incluir el mensaje entre comillas simples.
## Notas de uso
No puede cancelar una consulta al especificar un *query ID*; debe especificar el *process ID* (PID) o *Session ID* de la consulta. Solo puede cancelar consultas que su usuario esté ejecutando actualmente. Los superusuarios pueden cancelar todas las consultas.
Si las consultas en varias sesiones mantienen bloqueos en la misma tabla, puede utilizar la función [PG\$1TERMINATE\$1BACKEND](PG_TERMINATE_BACKEND.md) para terminar una de las sesiones. Esta acción obliga a las transacciones en curso de la sesión terminada a eliminar todos los bloqueos y revertir la transacción. Consulte la tabla de sistema [STV\$1LOCKS](r_STV_LOCKS.md) para ver los bloqueos actuales.
Después de determinados eventos internos, Amazon Redshift podría reiniciar una sesión activa y asignar un PID nuevo. Si el PID ha cambiado, es posible que reciba el siguiente mensaje de error.
```
Session does not exist. The session PID might have changed. Check the stl_restarted_sessions system table for details.
```
Para buscar el nuevo PID, consulte la tabla del sistema [STL\$1RESTARTED\$1SESSIONS](r_STL_RESTARTED_SESSIONS.md) y el filtro en la columna `oldpid`.
```
select oldpid, newpid from stl_restarted_sessions where oldpid = 1234;
```
## Ejemplos
Para cancelar una consulta que se esté ejecutando actualmente en un clúster de Amazon Redshift, primero recupere el ID de proceso para la consulta que desee cancelar. Para determinar los ID de proceso para todas las consultas en ejecución, escriba el siguiente comando:
```
select pid, starttime, duration,
trim(user_name) as user,
trim (query) as querytxt
from stv_recents
where status = 'Running';
pid | starttime | duration | user | querytxt
-----+----------------------------+----------+----------+-----------------
802 | 2008-10-14 09:19:03.550885 | 132 | dwuser | select
venuename from venue where venuestate='FL', where venuecity not in
('Miami' , 'Orlando');
834 | 2008-10-14 08:33:49.473585 | 1250414 | dwuser | select *
from listing;
964 | 2008-10-14 08:30:43.290527 | 326179 | dwuser | select
sellerid from sales where qtysold in (8, 10);
```
Revise el texto de la consulta para determinar cuál es el ID de proceso (PID) que corresponde a la consulta que desea cancelar.
Escriba el siguiente comando para usar PID 802 para cancelar esa consulta:
```
cancel 802;
```
La sesión donde se estaba ejecutando la consulta muestra el siguiente mensaje:
```
ERROR: Query (168) cancelled on user's request
```
donde `168` es el ID de consulta (no el ID de proceso utilizado para cancelar la consulta).
De manera opcional, puede especificar un mensaje de confirmación personalizado para mostrar en lugar del mensaje predeterminado. Para especificar un mensaje personalizado, incluya el mensaje entre comillas simples al final del comando CANCEL:
```
cancel 802 'Long-running query';
```
La sesión donde se estaba ejecutando la consulta muestra el siguiente mensaje:
```
ERROR: Long-running query
```
# CLOSE
(Opcional) Cierra todos los recursos libres que están asociados con un cursor abierto. [COMMIT](r_COMMIT.md), [END](r_END.md) y [ROLLBACK](r_ROLLBACK.md) cierran automáticamente el cursor, por lo que no es necesario utilizar el comando CLOSE para cerrarlo explícitamente.
Para obtener más información, consulte [DECLARE](declare.md), [FETCH](fetch.md).
## Sintaxis
```
CLOSE cursor
```
## Parameters
*cursor*
Nombre del cursor que se cerrará.
## Ejemplo de CLOSE
Los siguientes comandos cierran el cursor y realizan una confirmación, que finaliza la transacción:
```
close movie_cursor;
commit;
```
# COMMENT
Crea o cambia un comentario acerca de un objeto de la base de datos.
## Sintaxis
```
COMMENT ON
{
TABLE object_name |
COLUMN object_name.column_name |
CONSTRAINT constraint_name ON table_name |
DATABASE object_name |
VIEW object_name
}
IS 'text' | NULL
```
## Parameters
*object\$1name*
Nombre del objeto de la base de datos en el que se realiza un comentario. Puede agregar un comentario en los siguientes objetos:
+ TABLE
+ COLUMN (también lleva un valor *column\$1name [nombre\$1de\$1columna]*).
+ CONSTRAINT (también lleva un valor *constraint\$1name [nombre\$1de\$1restricción]* y un valor *table\$1name [nombre\$1de\$1tabla]*).
+ DATABASE
+ VIEW
+ SCHEMA
IS "*texto*"\$1NULL
El texto del comentario que desea agregar o sustituir para el objeto especificado. La cadena *texto* es el tipo de datos TEXT. Incluya el comentario entre comillas simples. Establezca el valor en NULL para eliminar el texto del comentario.
*column\$1name*
Nombre de la columna en la que se realiza un comentario. Parámetro de COLUMN. Sigue una tabla especificada en `object_name`.
*constraint\$1name*
Nombre de la restricción en la que se realiza un comentario. Parámetro de CONSTRAINT.
*table\$1name*
Nombre de una tabla que contiene la restricción. Parámetro de CONSTRAINT.
## Notas de uso
Para agregar o actualizar un comentario, debe ser un superusuario o el propietario de un objeto de base de datos.
Los comentarios en bases de datos solo pueden aplicarse a la base de datos actual. Se muestra un mensaje de advertencia si intenta comentar en una base de datos diferente. Aparece el mismo mensaje de advertencia sobre comentarios de bases de datos que no existen.
No se admiten comentarios en tablas externas, columnas externas ni columnas de vistas de enlace de tiempo de ejecución.
## Ejemplos
En el ejemplo siguiente se agrega un comentario a la tabla SALES.
```
COMMENT ON TABLE sales IS 'This table stores tickets sales data';
```
En el siguiente ejemplo, se muestra el comentario de la tabla SALES.
```
select obj_description('public.sales'::regclass);
obj_description
-------------------------------------
This table stores tickets sales data
```
En el siguiente ejemplo, se elimina un comentario de la tabla SALES.
```
COMMENT ON TABLE sales IS NULL;
```
En el siguiente ejemplo, se agrega un comentario a la columna EVENTID de la tabla SALES.
```
COMMENT ON COLUMN sales.eventid IS 'Foreign-key reference to the EVENT table.';
```
En el siguiente ejemplo, se muestra un comentario en la columna EVENTID (columna número 5) de la tabla SALES.
```
select col_description( 'public.sales'::regclass, 5::integer );
col_description
-----------------------------------------
Foreign-key reference to the EVENT table.
```
En el siguiente ejemplo, se agrega un comentario descriptivo a la tabla EVENT.
```
comment on table event is 'Contains listings of individual events.';
```
Consulte el catálogo del sistema PG\$1DESCRIPTION para ver una lista de comentarios. El siguiente ejemplo devuelve la descripción de la tabla EVENT.
```
select * from pg_catalog.pg_description
where objoid =
(select oid from pg_class where relname = 'event'
and relnamespace =
(select oid from pg_catalog.pg_namespace where nspname = 'public') );
objoid | classoid | objsubid | description
-------+----------+----------+----------------------------------------
116658 | 1259 | 0 | Contains listings of individual events.
```
# COMMIT
Confirma la transacción actual en la base de datos. Este comando hace que las actualizaciones de transacciones de la base de datos sean permanentes.
## Sintaxis
```
COMMIT [ WORK | TRANSACTION ]
```
## Parameters
WORK
Palabra clave opcional. Esta palabra clave no se admite en un proceso almacenado.
TRANSACTION
Palabra clave opcional. WORK y TRANSACTION son sinónimos. Ninguna de ellas se admite en un proceso almacenado.
Para más información sobre el uso de COMMIT en un proceso almacenado, vea [Administración de transacciones](stored-procedure-transaction-management.md).
## Ejemplos
Cada uno de los siguientes ejemplos confirma la transacción actual en la base de datos:
```
commit;
```
```
commit work;
```
```
commit transaction;
```
# COPY
| |
| --- |
| El cifrado del cliente para los comandos COPY y UNLOAD dejará de estar abierto a nuevos clientes a partir del 30 de abril de 2025. Si ha utilizado el cifrado del cliente con los comandos COPY y UNLOAD en los 12 meses anteriores al 30 de abril de 2025, puede seguir utilizando el cifrado del cliente con los comandos COPY o UNLOAD hasta el 30 de abril de 2026. Después del 30 de abril de 2026, no podrá utilizar el cifrado del cliente para COPY y UNLOAD. Le recomendamos que pase a utilizar el cifrado del servidor para COPY y UNLOAD lo antes posible. Si ya está utilizando el cifrado del servidor para COPY y UNLOAD, no hay ningún cambio y puede seguir utilizándolo sin alterar las consultas. Para obtener más información sobre el cifrado para COPY y UNLOAD, consulte el parámetro ENCRYPTED a continuación. |
Carga datos en una tabla desde archivos de datos o desde una tabla de Amazon DynamoDB. Los archivos pueden encontrarse en un bucket de Amazon Simple Storage Service (Amazon S3), un clúster de Amazon EMR o un alojamiento remoto al que se puede acceder mediante una conexión Secure Shell (SSH).
**nota**
Las tablas externas de Amazon Redshift Spectrum solo se pueden leer. No puede aplicar COPY a una tabla externa.
El comando COPY anexa los datos de entrada como filas adicionales a la tabla.
El tamaño máximo de una fila de entrada única de cualquier origen es de 4 MB.
**Topics**
+ [Permisos necesarios](#r_COPY-permissions)
+ [Sintaxis de COPY](#r_COPY-syntax)
+ [Parámetros necesarios](#r_COPY-syntax-required-parameters)
+ [Parámetros opcionales](#r_COPY-syntax-overview-optional-parameters)
+ [Notas de uso y recursos adicionales para el comando COPY](#r_COPY-using-the-copy-command)
+ [Ejemplos del comando COPY](#r_COPY-using-the-copy-command-examples)
+ [COPY JOB](r_COPY-JOB.md)
+ [COPY con TEMPLATE](r_COPY-WITH-TEMPLATE.md)
+ [Referencia de parámetros de COPY](r_COPY-parameters.md)
+ [Notas de uso](r_COPY_usage_notes.md)
+ [Ejemplos de COPY](r_COPY_command_examples.md)
## Permisos necesarios
Para utilizar el comando COPY, debe tener el privilegio [INSERT](r_GRANT.md#grant-insert) para la tabla de Amazon Redshift.
## Sintaxis de COPY
```
COPY table-name
[ column-list ]
FROM data_source
authorization
[ [ FORMAT ] [ AS ] data_format ]
[ parameter [ argument ] [, ... ] ]
```
Puede realizar una operación COPY con un mínimo de tres parámetros: un nombre de tabla, un origen de datos y una autorización para obtener acceso a los datos.
Amazon Redshift extiende la funcionalidad del comando COPY para permitir la carga de datos en varios formatos de datos de varios orígenes de datos, el control del acceso a los datos de carga, la administración de las transformaciones de datos y la administración de la operación de carga.
Las siguientes secciones presentan los parámetros requeridos del comando COPY, mediante la agrupación de los parámetros opcionales por función. También describen cada parámetro y explican el funcionamiento conjunto de las distintas opciones. Puede ir directamente a la descripción de un parámetro mediante la lista alfabética de parámetros.
## Parámetros necesarios
El comando COPY requiere tres elementos:
+ [Table Name](#r_COPY-syntax-overview-table-name)
+ [Data Source](#r_COPY-syntax-overview-data-source)
+ [Authorization](#r_COPY-syntax-overview-credentials)
El comando COPY más sencillo utiliza el siguiente formato.
```
COPY table-name
FROM data-source
authorization;
```
En el siguiente ejemplo, se crea una tabla denominada CATDEMO y luego se carga la tabla con datos de ejemplo de un archivo de datos de Amazon S3 denominado `category_pipe.txt`.
```
create table catdemo(catid smallint, catgroup varchar(10), catname varchar(10), catdesc varchar(50));
```
En el siguiente ejemplo, el origen de datos del comando COPY es un archivo de datos llamado `category_pipe.txt` que se encuentra en la carpeta `tickit` de un bucket de Amazon S3 denominado `redshift-downloads`. El comando COPY tiene autorización para acceder al bucket de Amazon S3 a través de un rol de AWS Identity and Access Management (IAM). Si el clúster tiene adjunto un rol de IAM ya existente con permiso para acceder a Amazon S3, puede sustituir el nombre de recurso de Amazon (ARN) del rol en el siguiente comando COPY y ejecutarlo.
```
copy catdemo
from 's3://redshift-downloads/tickit/category_pipe.txt'
iam_role 'arn:aws:iam:::role/'
region 'us-east-1';
```
Para obtener instrucciones completas sobre cómo se utilizan los comandos COPY para cargar datos de muestra, incluidas las instrucciones para cargar datos de otras regiones de AWS, consulte [Cargar datos de muestra desde Amazon S3](https://docs.aws.amazon.com/redshift/latest/gsg/rs-gsg-create-sample-db.html) en la Guía de introducción a Amazon Redshift.
*table-name (nombre-tabla*
El nombre de la tabla de destino para el comando COPY. La tabla ya debe existir en la base de datos. La tabla puede ser temporal o persistente. El comando COPY adjunta los nuevos datos de entrada a cualquier fila existente en la tabla.
FROM *data-source (origen-datos)*
La ubicación de los datos de origen que se van a cargar en la tabla de destino. Puede especificarse un archivo de manifiesto con algunos orígenes de datos.
El repositorio de datos más utilizado es un bucket de Amazon S3. También puede cargar datos de archivos de datos ubicados en un clúster de Amazon EMR, una instancia de Amazon EC2 o un alojamiento remoto al que el clúster puede acceder a través de una conexión SSH, o puede cargarlos directamente desde una tabla de DynamoDB.
+ [COPY de Amazon S3](copy-parameters-data-source-s3.md)
+ [COPY de Amazon EMR](copy-parameters-data-source-emr.md)
+ [COPY de hosts remotos (SSH)](copy-parameters-data-source-ssh.md)
+ [COPY de Amazon DynamoDB](copy-parameters-data-source-dynamodb.md)
Autorización
Se trata de una cláusula que indica el método que el clúster utiliza para la autenticación y la autorización con objeto de acceder a otros recursos de AWS. El comando COPY necesita autorización para acceder a los datos de otro recurso de AWS, incluidos los recursos de Amazon S3, Amazon EMR, Amazon DynamoDB y Amazon EC2. Puede proporcionar esa autorización haciendo referencia a un rol de IAM que esté asociado al clúster o proporcionando el ID de clave de acceso y la clave de acceso secreta de un usuario de IAM.
+ [Parámetros de autorización](copy-parameters-authorization.md)
+ [Control de acceso con base en roles](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based)
+ [Control de acceso basado en claves](copy-usage_notes-access-permissions.md#copy-usage_notes-access-key-based)
## Parámetros opcionales
De forma opcional, puede especificar el modo en que COPY asigna los datos de campo a las columnas de la tabla de destino, definir los atributos de datos de origen para permitir al comando COPY leer y analizar los datos de origen de forma correcta y administrar qué operaciones realiza el comando COPY durante el proceso de carga.
+ [Opciones de mapeo de columnas](copy-parameters-column-mapping.md)
+ [Parámetros de formato de datos](#r_COPY-syntax-overview-data-format)
+ [Parámetros de conversión de datos](#r_COPY-syntax-overview-data-conversion)
+ [Operaciones de carga de datos](#r_COPY-syntax-overview-data-load)
### Mapeo de columnas
De manera predeterminada, COPY inserta los valores de campo en las columnas de la tabla de destino en el mismo orden que aparecen los campos en los archivos de datos. Si el orden de columnas predeterminado no funcionará, puede especificar una lista de columnas o utilizar las expresiones JSONPath para asignar los campos de datos de origen a las columnas de destino.
+ [Column List](copy-parameters-column-mapping.md#copy-column-list)
+ [JSONPaths File](copy-parameters-column-mapping.md#copy-column-mapping-jsonpaths)
### Parámetros de formato de datos
Puede cargar datos de archivos de texto en formato JSON, de valores separados por coma (CSV), de ancho fijo o delimitados por caracteres, o de archivos de Avro.
De manera predeterminada, el comando COPY espera que los datos de origen estén en archivos de texto UTF-8 delimitados por caracteres. El delimitador predeterminado es el carácter de barra vertical ( \$1 ). Si los datos de origen están en otro formato, utilice los siguientes parámetros para especificar el formato de datos.
+ [FORMAT](copy-parameters-data-format.md#copy-format)
+ [CSV](copy-parameters-data-format.md#copy-csv)
+ [DELIMITER](copy-parameters-data-format.md#copy-delimiter)
+ [FIXEDWIDTH](copy-parameters-data-format.md#copy-fixedwidth)
+ [SHAPEFILE](copy-parameters-data-format.md#copy-shapefile)
+ [AVRO](copy-parameters-data-format.md#copy-avro)
+ [JSON format for COPY](copy-parameters-data-format.md#copy-json)
+ [ENCRYPTED](copy-parameters-data-source-s3.md#copy-encrypted)
+ [BZIP2](copy-parameters-file-compression.md#copy-bzip2)
+ [GZIP](copy-parameters-file-compression.md#copy-gzip)
+ [LZOP](copy-parameters-file-compression.md#copy-lzop)
+ [PARQUET](copy-parameters-data-format.md#copy-parquet)
+ [ORC](copy-parameters-data-format.md#copy-orc)
+ [ZSTD](copy-parameters-file-compression.md#copy-zstd)
### Parámetros de conversión de datos
A medida que carga la tabla, COPY intenta convertir de forma implícita las cadenas de los datos de origen al tipo de datos de la columna de destino. Si necesita especificar una conversión que sea diferente a la del comportamiento predeterminado, o si la conversión predeterminada da lugar a errores, puede administrar las conversiones de datos especificando los siguientes parámetros.
+ [ACCEPTANYDATE](copy-parameters-data-conversion.md#copy-acceptanydate)
+ [ACCEPTINVCHARS](copy-parameters-data-conversion.md#copy-acceptinvchars)
+ [BLANKSASNULL](copy-parameters-data-conversion.md#copy-blanksasnull)
+ [DATEFORMAT](copy-parameters-data-conversion.md#copy-dateformat)
+ [EMPTYASNULL](copy-parameters-data-conversion.md#copy-emptyasnull)
+ [ENCODING](copy-parameters-data-conversion.md#copy-encoding)
+ [ESCAPE](copy-parameters-data-conversion.md#copy-escape)
+ [EXPLICIT_IDS](copy-parameters-data-conversion.md#copy-explicit-ids)
+ [FILLRECORD](copy-parameters-data-conversion.md#copy-fillrecord)
+ [IGNOREBLANKLINES](copy-parameters-data-conversion.md#copy-ignoreblanklines)
+ [IGNOREHEADER](copy-parameters-data-conversion.md#copy-ignoreheader)
+ [NULL AS](copy-parameters-data-conversion.md#copy-null-as)
+ [REMOVEQUOTES](copy-parameters-data-conversion.md#copy-removequotes)
+ [ROUNDEC](copy-parameters-data-conversion.md#copy-roundec)
+ [TIMEFORMAT](copy-parameters-data-conversion.md#copy-timeformat)
+ [TRIMBLANKS](copy-parameters-data-conversion.md#copy-trimblanks)
+ [TRUNCATECOLUMNS](copy-parameters-data-conversion.md#copy-truncatecolumns)
### Operaciones de carga de datos
Administre el comportamiento predeterminado de la operación de carga para solucionar problemas o reducir los tiempos de carga especificando los siguientes parámetros.
+ [COMPROWS](copy-parameters-data-load.md#copy-comprows)
+ [COMPUPDATE](copy-parameters-data-load.md#copy-compupdate)
+ [IGNOREALLERRORS](copy-parameters-data-load.md#copy-ignoreallerrors)
+ [MAXERROR](copy-parameters-data-load.md#copy-maxerror)
+ [NOLOAD](copy-parameters-data-load.md#copy-noload)
+ [STATUPDATE](copy-parameters-data-load.md#copy-statupdate)
## Notas de uso y recursos adicionales para el comando COPY
Para obtener más información acerca de cómo utilizar el comando COPY, consulte los siguientes temas:
+ [Notas de uso](r_COPY_usage_notes.md)
+ [Tutorial: Carga de datos desde Amazon S3](tutorial-loading-data.md)
+ [Prácticas recomendadas de Amazon Redshift para la carga de datos](c_loading-data-best-practices.md)
+ [Carga de tablas con el comando COPY](t_Loading_tables_with_the_COPY_command.md)
+ [Carga de datos desde Amazon S3](t_Loading-data-from-S3.md)
+ [Carga de datos desde Amazon EMR](loading-data-from-emr.md)
+ [Carga de datos desde hosts remotos](loading-data-from-remote-hosts.md)
+ [Carga de datos desde una tabla de Amazon DynamoDB](t_Loading-data-from-dynamodb.md)
+ [Solución de problemas en cargas de datos](t_Troubleshooting_load_errors.md)
## Ejemplos del comando COPY
Para ver más ejemplos que muestran cómo usar COPY desde varios orígenes, en formatos dispares y con diferentes opciones de COPY, consulte [Ejemplos de COPY](r_COPY_command_examples.md).
# COPY JOB
Para obtener más información acerca del uso de este comando, consulte [Creación de una integración de eventos de S3 para copiar automáticamente archivos desde buckets de Amazon S3](loading-data-copy-job.md).
Administra los comandos COPY que cargan datos en una tabla. El comando COPY JOB es una extensión del comando COPY y automatiza la carga de datos desde buckets de Amazon S3. Al crear un trabajo COPY, Amazon Redshift detecta cuándo se crean nuevos archivos de Amazon S3 en una ruta especificada y, a continuación, los carga automáticamente sin su intervención. Al cargar los datos se utilizan los mismos parámetros que en el comando COPY original. Amazon Redshift realiza un seguimiento de los archivos cargados (basándose en el nombre de archivo) para verificar que se cargan solo una vez.
**nota**
Para obtener información sobre el comando COPY, como su uso, parámetros y permisos, consulte [COPY](r_COPY.md).
## Permiso necesario
Para utilizar el comando COPY JOB, debe tener uno de los siguientes permisos, además de todos los permisos necesarios para utilizar COPY:
+ Superusuario
+ Todos los siguientes:
+ El permiso CREATE, ALTER o DROP correspondiente con ámbito para COPY JOBS en la base de datos en la que desea utilizar COPY.
+ El permiso USAGE para el esquema en el que desea utilizar COPY o el permiso USAGE con ámbito para los esquemas de la base de datos en la que desea utilizar COPY.
+ El permiso INSERT para la tabla en el que desea utilizar COPY o el permiso INSERT con ámbito para las tablas del esquema o la base de datos en el que desea utilizar COPY.
El rol de IAM especificado con el comando COPY debe tener permiso para acceder a los datos que se van a cargar. Para obtener más información, consulte [Permisos de IAM para COPY, UNLOAD y CREATE LIBRARY](copy-usage_notes-access-permissions.md#copy-usage_notes-iam-permissions).
## Sintaxis
Crear un trabajo de copia. Los parámetros del comando COPY se guardan con el trabajo de copia.
No puede ejecutar COPY JOB CREATE dentro del ámbito de un bloque de transacciones.
```
COPY copy-command JOB CREATE job-name
[AUTO ON | OFF]
```
Cambiar la configuración de un trabajo de copia.
```
COPY JOB ALTER job-name
[AUTO ON | OFF]
```
Ejecutar un trabajo de copia. Se utilizan los parámetros del comando COPY almacenados.
```
COPY JOB RUN job-name
```
Enumerar todos los trabajos de copia.
```
COPY JOB LIST
```
Mostrar los detalles de un trabajo de copia.
```
COPY JOB SHOW job-name
```
Eliminar un trabajo de copia.
No puede ejecutar COPY JOB DROP dentro del ámbito de un bloque de transacciones.
```
COPY JOB DROP job-name
```
## Parameters
*copy-command*
Un comando COPY que carga datos desde Amazon S3 en Amazon Redshift. La cláusula contiene los parámetros COPY que definen el bucket de Amazon S3, la tabla de destino, el rol de IAM y otros parámetros que se utilizan al cargar datos. Se admiten todos los parámetros del comando COPY para una carga de datos de Amazon S3, con las siguientes excepciones:
+ COPY JOB no ingiere archivos preexistentes en la carpeta a la que apunta el comando COPY. Solo se ingieren los archivos creados después de la marca de tiempo de creación de COPY JOB.
+ No puede especificar un comando COPY con las opciones MAXERROR o IGNOREALLERRORS.
+ No puede especificar un archivo de manifiesto. COPY JOB requiere una ubicación de Amazon S3 designada para supervisar los archivos recién creados.
+ No puede especificar un comando COPY con tipos de autorización como Acceso y Claves secretas. Solo se admiten los comandos COPY que utilizan el parámetro `IAM_ROLE` para la autorización. Para obtener más información, consulte [Parámetros de autorización](copy-parameters-authorization.md).
+ COPY JOB no admite el rol de IAM predeterminado asociado al clúster. Debe especificar `IAM_ROLE` en el comando COPY.
Para obtener más información, consulte [COPY de Amazon S3](copy-parameters-data-source-s3.md).
*job-name*
El nombre del trabajo que se usa para hacer referencia al trabajo COPY. El valor de *job-name* no puede contener un guion (‐).
[AUTO ON \$1 OFF]
Cláusula que indica si los datos de Amazon S3 se cargan automáticamente en las tablas de Amazon Redshift.
+ Si es `ON`, Amazon Redshift supervisa la ruta de origen de Amazon S3 en busca de archivos recién creados y, si los encuentra, se ejecuta un comando COPY con los parámetros de COPY en la definición del trabajo. Esta es la opción predeterminada.
+ Si es `OFF`, Amazon Redshift no ejecuta COPY JOB automáticamente.
## Notas de uso
Las opciones del comando COPY no se validan hasta el momento de la ejecución. Por ejemplo, un `IAM_ROLE` no válido o un origen de datos de Amazon S3 provoca errores de ejecución cuando se inicia COPY JOB.
Si el clúster está en pausa, no se ejecutan los comandos COPY JOB.
Para consultar los archivos del comando COPY cargados y los errores de carga, consulte [STL\$1LOAD\$1COMMITS](r_STL_LOAD_COMMITS.md), [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) y [STL\$1LOADERROR\$1DETAIL](r_STL_LOADERROR_DETAIL.md). Para obtener más información, consulte [Comprobación de carga correcta de datos](verifying-that-data-loaded-correctly.md).
Los COPY JOBS no son compatibles con las bases de datos zero-ETL, ya que funcionan en modo de solo lectura.
## Ejemplos
En el siguiente ejemplo se muestra la creación de un trabajo COPY JOB para cargar datos de un bucket de Amazon S3.
```
COPY public.target_table
FROM 's3://amzn-s3-demo-bucket/staging-folder'
IAM_ROLE 'arn:aws:iam::123456789012:role/MyLoadRoleName'
JOB CREATE my_copy_job_name
AUTO ON;
```
# COPY con TEMPLATE
Puede utilizar plantillas de Redshift con comandos COPY para simplificar la sintaxis de los comandos y garantizar la coherencia en todas las operaciones de carga de datos. En lugar de especificar los mismos parámetros de formato repetidamente, los define una vez en una plantilla y hace referencia a la plantilla en sus comandos COPY. Cuando utiliza una plantilla, el comando COPY combina los parámetros de la plantilla con cualquier parámetro especificado directamente en el comando. Si el mismo parámetro aparece tanto en la plantilla como en el comando, el parámetro del comando tiene prioridad. Para obtener más información, consulte [CREATE TEMPLATE](r_CREATE_TEMPLATE.md).
Las plantillas para el comando COPY se pueden crear con:
+ [Parámetros de formato de datos](copy-parameters-data-format.md)
+ [Parámetros de compresión de archivos](copy-parameters-file-compression.md)
+ [Parámetros de conversión de datos](copy-parameters-data-conversion.md)
+ [Operaciones de carga de datos](copy-parameters-data-load.md)
Para obtener una lista completa de los parámetros admitidos, consulte el comando [COPY](r_COPY.md).
## Permiso necesario
Para utilizar una plantilla en un comando COPY, debe tener:
+ Todos los permisos necesarios para ejecutar el comando COPY (consulte [Permisos necesarios](r_COPY.md#r_COPY-permissions))
+ Uno de los permisos de plantilla siguientes:
+ Privilegios de superusuario
+ Privilegio USAGE sobre la plantilla y privilegio USAGE sobre el esquema que contiene la plantilla
## Sintaxis
```
COPY target_table FROM 's3://...'
authorization
[ option, ...]
USING TEMPLATE [database_name.][schema_name.]template_name;
```
## Parameters
*database\$1name*
(Opcional) El nombre de la base de datos donde se encuentra la plantilla. Si no se especifica, se utiliza la base de datos actual.
*schema\$1name*
(Opcional) El nombre del esquema donde se encuentra la plantilla. Si no se especifica, la plantilla se busca en la ruta de búsqueda actual.
*template\$1name*
El nombre de la plantilla que se utilizará en COPY.
## Notas de uso
+ Los parámetros específicos del comando (origen, destino, autorización) deben seguir especificándose en el comando COPY.
+ Las plantillas no pueden contener especificaciones de archivos manifiestos para comandos COPY.
## Ejemplos
Los ejemplos siguientes muestran cómo crear una plantilla y utilizarla en comandos COPY:
```
CREATE TEMPLATE public.test_template FOR COPY AS
CSV DELIMITER '|' IGNOREHEADER 1 MAXERROR 100;
COPY public.target_table
FROM 's3://amzn-s3-demo-bucket/staging-folder'
IAM_ROLE 'arn:aws:iam::123456789012:role/MyLoadRoleName'
USING TEMPLATE public.test_template;
```
Cuando un parámetro existe tanto en la plantilla como en el comando, el parámetro del comando tiene prioridad. En este ejemplo, si la plantilla `public.test_template` contiene `DELIMITER '|'` pero el comando COPY especifica `DELIMITER ','`, se usará el delimitador de coma (`,`) del comando en lugar de la barra vertical (`|`) de la plantilla.
```
COPY public.target_table
FROM 's3://amzn-s3-demo-bucket/staging-folder'
IAM_ROLE 'arn:aws:iam::123456789012:role/MyLoadRoleName'
DELIMITER ','
USING TEMPLATE public.test_template;
```
# Referencia de parámetros de COPY
COPY tiene muchos parámetros que se pueden utilizar en muchas situaciones. Sin embargo, no todos los parámetros son compatibles en cada situación. Por ejemplo, para cargar desde archivos ORC o PARQUET, se admite un número limitado de parámetros. Para obtener más información, consulte [Uso de COPY con formatos de datos de columnas](copy-usage_notes-copy-from-columnar.md).
**Topics**
+ [Orígenes de datos](copy-parameters-data-source.md)
+ [Parámetros de autorización](copy-parameters-authorization.md)
+ [Opciones de mapeo de columnas](copy-parameters-column-mapping.md)
+ [Parámetros de formato de datos](copy-parameters-data-format.md)
+ [Parámetros de compresión de archivos](copy-parameters-file-compression.md)
+ [Parámetros de conversión de datos](copy-parameters-data-conversion.md)
+ [Operaciones de carga de datos](copy-parameters-data-load.md)
+ [Lista alfabética de parámetros](r_COPY-alphabetical-parm-list.md)
# Orígenes de datos
Puede cargar datos de archivos de texto en un bucket de Amazon S3, un clúster de Amazon EMR o un alojamiento remoto al cual el clúster pueda acceder a través de una conexión SSH. También puede cargar datos de forma directa desde una tabla de DynamoDB.
El tamaño máximo de una fila de entrada única de cualquier origen es de 4 MB.
Para exportar los datos de una tabla a un conjunto de archivos en Amazon S3, utilice el comando [UNLOAD](r_UNLOAD.md).
**Topics**
+ [COPY de Amazon S3](copy-parameters-data-source-s3.md)
+ [COPY de Amazon EMR](copy-parameters-data-source-emr.md)
+ [COPY de hosts remotos (SSH)](copy-parameters-data-source-ssh.md)
+ [COPY de Amazon DynamoDB](copy-parameters-data-source-dynamodb.md)
# COPY de Amazon S3
Para cargar datos de archivos ubicados en uno o más buckets de S3, utilice la cláusula FROM para indicar el modo en que COPY localiza los archivos de Amazon S3. Puede proporcionar la ruta de objeto a los archivos de datos como parte de la cláusula FROM o puede proporcionar la ubicación de un archivo de manifiesto que contenga una lista de rutas de objetos de Amazon S3. COPY de Amazon S3 utiliza una conexión HTTPS. Asegúrese de que los rangos de IP de S3 estén agregados a la lista de permitidos. Para obtener más información acerca de los rangos de IP de S3 necesarios, consulte [Aislamiento de red](https://docs.aws.amazon.com//redshift/latest/mgmt/security-network-isolation.html#network-isolation).
**importante**
Si los buckets de Amazon S3 que contienen los archivos de datos no se encuentran en la misma región de AWS que el clúster, debe utilizar el parámetro [REGION](#copy-region) para especificar la región en la que se encuentran los datos.
**Topics**
+ [Sintaxis](#copy-parameters-data-source-s3-syntax)
+ [Ejemplos](#copy-parameters-data-source-s3-examples)
+ [Parámetros opcionales](#copy-parameters-data-source-s3-optional-parms)
+ [Parámetros no admitidos](#copy-parameters-data-source-s3-unsupported-parms)
## Sintaxis
```
FROM { 's3://objectpath' | 's3://manifest_file' }
authorization
| MANIFEST
| ENCRYPTED
| REGION [AS] 'aws-region'
| optional-parameters
```
## Ejemplos
En el siguiente ejemplo, se utiliza una ruta de objeto para cargar datos desde Amazon S3.
```
copy customer
from 's3://amzn-s3-demo-bucket/customer'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole';
```
En el siguiente ejemplo, se utiliza un archivo de manifiesto para cargar datos desde Amazon S3.
```
copy customer
from 's3://amzn-s3-demo-bucket/cust.manifest'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
manifest;
```
### Parameters
FROM
El origen de los datos a cargar. Para obtener más información acerca de la codificación del archivo de Amazon S3, consulte [Parámetros de conversión de datos](copy-parameters-data-conversion.md).
's3://*copy\$1from\$1s3\$1objectpath*'
Especifica la ruta a los objetos de Amazon S3 que contienen los datos; por ejemplo, `'s3://amzn-s3-demo-bucket/custdata.txt'`. El parámetro *s3://copy\$1from\$1s3\$1objectpath* puede hacer referencia a un único archivo o a un conjunto de objetos o carpetas que tienen el mismo prefijo de clave. Por ejemplo, el nombre `custdata.txt` es un prefijo de clave que hace referencia a un número de archivos físicos: `custdata.txt`, `custdata.txt.1`, `custdata.txt.2`, `custdata.txt.bak` y así sucesivamente. El prefijo de clave también puede hacer referencia a un número de carpetas. Por ejemplo, `'s3://amzn-s3-demo-bucket/custfolder'` hace referencia a las carpetas `custfolder`, `custfolder_1`, `custfolder_2` y así sucesivamente. Si un prefijo de clave hace referencia a varias carpetas, se cargan todos los archivos de esas carpetas. Si un prefijo de clave coincide con un archivo y, a su vez, con una carpeta, como `custfolder.log`, COPY también intenta cargar el archivo. Si un prefijo de clave puede dar lugar a que COPY intente cargar archivos no deseados, utilice un archivo de manifiesto. Para obtener más información, consulte [copy_from_s3_manifest_file](#copy-manifest-file), a continuación.
Si el bucket de S3 que contiene los archivos de datos no se encuentra en la misma región de AWS que el clúster, debe utilizar el parámetro [REGION](#copy-region) para especificar la región en la que se encuentran los datos.
Para obtener más información, consulte [Carga de datos desde Amazon S3](t_Loading-data-from-S3.md).
's3://*copy\$1from\$1s3\$1manifest\$1file*'
Especifica la clave de objeto de Amazon S3 para un archivo de manifiesto que muestra los archivos de datos que se cargarán. El argumento *'s3://*copy\$1from\$1s3\$1manifest\$1file'** debe referenciar de forma explícita un solo archivo; por ejemplo, `'s3://amzn-s3-demo-bucket/manifest.txt'`. No puede hacer referencia a un prefijo de clave.
El manifiesto es un archivo de texto en formato JSON que muestra la dirección URL de cada archivo que se cargará desde Amazon S3. El URL incluye el nombre del bucket y la ruta de objeto completa para el archivo. Los archivos que se especifican en el manifiesto pueden estar en buckets diferentes, pero todos los buckets deben estar en la misma región de AWS que el clúster de Amazon Redshift. Si un archivo aparece dos veces, este se carga dos veces. En el siguiente ejemplo, se muestra el JSON para un manifiesto que carga tres archivos.
```
{
"entries": [
{"url":"s3://amzn-s3-demo-bucket1/custdata.1","mandatory":true},
{"url":"s3://amzn-s3-demo-bucket1/custdata.2","mandatory":true},
{"url":"s3://amzn-s3-demo-bucket2/custdata.1","mandatory":false}
]
}
```
Se requieren caracteres de comillas dobles y estas deben ser las comillas simples (0x22), no las comillas inclinadas o “inteligentes”. Cada entrada en el manifiesto puede incluir opcionalmente una marca `mandatory`. Cuando `mandatory` está establecido en `true`, COPY termina si no encuentra el archivo de esa entrada. De lo contrario, COPY continúa. El valor predeterminado de `mandatory` es `false`.
Cuando la carga se realiza a partir de archivos de datos con formato ORC o Parquet, se necesita un campo `meta`, tal y como se muestra en el siguiente ejemplo.
```
{
"entries":[
{
"url":"s3://amzn-s3-demo-bucket1/orc/2013-10-04-custdata",
"mandatory":true,
"meta":{
"content_length":99
}
},
{
"url":"s3://amzn-s3-demo-bucket2/orc/2013-10-05-custdata",
"mandatory":true,
"meta":{
"content_length":99
}
}
]
}
```
El archivo de manifiesto no debe estar cifrado o comprimido, incluso si se especifican las opciones ENCRYPTED, GZIP, LZOP, BZIP2 o ZSTD. COPY devuelve un error si el archivo de manifiesto especificado no se encuentra o no se creó de forma correcta.
Si se utiliza un archivo de manifiesto, se debe especificar el parámetro MANIFEST con el comando COPY. Si no se especifica el parámetro MANIFEST, COPY supone que el archivo especificado con FROM es un archivo de datos.
Para obtener más información, consulte [Carga de datos desde Amazon S3](t_Loading-data-from-S3.md).
*authorization*
El comando COPY necesita autorización para acceder a los datos de otro recurso de AWS, incluidos los recursos de Amazon S3, Amazon EMR, Amazon DynamoDB y Amazon EC2. Puede proporcionar esa autorización referenciando un rol de AWS Identity and Access Management (IAM) que esté adjunto al clúster (control de acceso basado en roles) o proporcionando las credenciales de acceso de un usuario (control de acceso basado en claves). Para mayor seguridad y flexibilidad, le recomendamos utilizar un control de acceso basado en roles de IAM. Para obtener más información, consulte [Parámetros de autorización](copy-parameters-authorization.md).
MANIFEST
Especifica que se utiliza un manifiesto para identificar los archivos de datos que se cargarán desde Amazon S3. Si se utiliza el parámetro MANIFEST, COPY carga los datos de los archivos que se muestran en el manifiesto al que se hace referencia en *'s3://copy\$1from\$1s3\$1manifest\$1file'*. Si no se encuentra el archivo de manifiesto o no se creó de forma correcta, COPY no se ejecuta correctamente. Para obtener más información, consulte [Uso de un manifiesto para especificar archivos de datos](loading-data-files-using-manifest.md).
ENCRYPTED
Se trata de una cláusula que especifica que los archivos de entrada en Amazon S3 están cifrados con el cifrado del lado del cliente con claves administradas por el cliente. Para obtener más información, consulte [Carga de archivos de datos cifrados desde Amazon S3](c_loading-encrypted-files.md). No especifique ENCRYPTED si los archivos de entrada están cifrados con el cifrado de servidor de Amazon S3 (SSE-KMS o SSE-S3). COPY lee automáticamente los archivos con cifrados del servidor.
Si especifica el parámetro ENCRYPTED, también debe especificar el parámetro [MASTER_SYMMETRIC_KEY](#copy-master-symmetric-key) o incluir el valor **master\$1symmetric\$1key** en la cadena [Uso del parámetro CREDENTIALS](copy-parameters-authorization.md#copy-credentials).
Si los archivos cifrados están en un formato comprimido, agregue el parámetro GZIP, LZOP, BZIP2 o ZSTD.
Los archivos de manifiesto y los archivos JSONPaths no deben cifrarse aunque la opción ENCRYPTED esté especificada.
MASTER\$1SYMMETRIC\$1KEY '*root\$1key*'
Se trata de la clave raíz simétrica que se utilizó para cifrar los archivos de datos en Amazon S3. Si se especifica MASTER\$1SYMMETRIC\$1KEY, también se debe especificar el parámetro [ENCRYPTED](#copy-encrypted). MASTER\$1SYMMETRIC\$1KEY no puede utilizarse con el parámetro CREDENTIALS. Para obtener más información, consulte [Carga de archivos de datos cifrados desde Amazon S3](c_loading-encrypted-files.md).
Si los archivos cifrados están en un formato comprimido, agregue el parámetro GZIP, LZOP, BZIP2 o ZSTD.
REGION [AS] '*aws\$1region*'
Especifica la región de AWS en la que se encuentran los datos de origen. Cuando el recurso de AWS que contiene los datos no se encuentra en la misma región que el clúster de Amazon Redshift, se debe utilizar REGION para el comando COPY de un bucket de Amazon S3 o una tabla de DynamoDB
El valor de *aws\$1region* debe coincidir con una de las regiones que aparecen en la tabla [Regiones y puntos de enlace de Amazon Redshift](https://docs.aws.amazon.com/general/latest/gr/rande.html#redshift_region).
Si se especifica el parámetro REGION, todos los recursos, incluidos un archivo de manifiesto o varios buckets de Amazon S3, deben encontrarse en la región especificada.
La transferencia de datos entre regiones genera cargos adicionales en el bucket de Amazon S3 o la tabla de DynamoDB que contiene los datos. Para obtener más información acerca de los precios, consulte **Transferencia OUT de datos de Amazon S3 a otra región de AWS** en la página [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/) y **Transferencia OUT de datos** en la página [Precios de Amazon DynamoDB](https://aws.amazon.com/dynamodb/pricing/).
De manera predeterminada, COPY supone que los datos se encuentran en la misma región que el clúster de Amazon Redshift.
## Parámetros opcionales
Si lo prefiere, puede especificar los siguientes parámetros con COPY de Amazon S3:
+ [Opciones de mapeo de columnas](copy-parameters-column-mapping.md)
+ [Parámetros de formato de datos](copy-parameters-data-format.md#copy-data-format-parameters)
+ [Parámetros de conversión de datos](copy-parameters-data-conversion.md)
+ [Operaciones de carga de datos](copy-parameters-data-load.md)
## Parámetros no admitidos
No puede utilizar los siguientes parámetros con COPY de Amazon S3:
+ SSH
+ READRATIO
# COPY de Amazon EMR
Puede utilizar el comando COPY para cargar datos en paralelo desde un clúster de Amazon EMR configurado para escribir archivos de texto en el sistema de archivos Hadoop Distributed File System (HDFS) del clúster como archivos de ancho fijo, archivos delimitados por caracteres, archivos CSV, archivos con formato JSON o archivos Avro.
**Topics**
+ [Sintaxis](#copy-parameters-data-source-emr-syntax)
+ [Ejemplo](#copy-parameters-data-source-emr-example)
+ [Parameters](#copy-parameters-data-source-emr-parameters)
+ [Parámetros admitidos](#copy-parameters-data-source-emr-optional-parms)
+ [Parámetros no admitidos](#copy-parameters-data-source-emr-unsupported-parms)
## Sintaxis
```
FROM 'emr://emr_cluster_id/hdfs_filepath'
authorization
[ optional_parameters ]
```
## Ejemplo
En el siguiente ejemplo, se cargan datos desde un clúster de Amazon EMR.
```
copy sales
from 'emr://j-SAMPLE2B500FC/myoutput/part-*'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole';
```
## Parameters
FROM
El origen de los datos a cargar.
'emr://*emr\$1cluster\$1id*/*hdfs\$1file\$1path*'
Se trata del identificador único para el clúster de Amazon EMR y la ruta del archivo de HDFS que referencia los archivos de datos para el comando COPY. Los nombres de los archivos de datos HDFS no deben contener los caracteres comodín de asterisco (\$1) ni de signos de interrogación (?).
El clúster de Amazon EMR debe seguir en ejecución hasta que se complete la operación COPY. Si se cambia o se elimina cualquiera de los archivos de datos HDFS antes de que se complete la operación COPY, se pueden obtener resultados inesperados o la operación COPY puede fallar.
Puede utilizar los caracteres comodín asterisco (\$1) y signo de puntuación (?) en el argumento *hdfs\$1file\$1path* para especificar que se carguen varios archivos. Por ejemplo, `'emr://j-SAMPLE2B500FC/myoutput/part*'` identifica los archivos `part-0000`, `part-0001` y así sucesivamente. Si la ruta de archivo no contiene caracteres comodín, se trata como si fuera un literal de cadena. Si solo especifica el nombre de una carpeta, COPY prueba cargar todos los archivos que se encuentran en ella.
Si utiliza caracteres comodín o solo el nombre de la carpeta, verifique que no se cargarán archivos no deseados. Por ejemplo, algunos procesos podrían escribir un archivo de registro en la carpeta de salida.
Para obtener más información, consulte [Carga de datos desde Amazon EMR](loading-data-from-emr.md).
*authorization*
El comando COPY necesita autorización para acceder a los datos de otro recurso de AWS, incluidos los recursos de Amazon S3, Amazon EMR, Amazon DynamoDB y Amazon EC2. Puede proporcionar esa autorización referenciando un rol de AWS Identity and Access Management (IAM) que esté adjunto al clúster (control de acceso basado en roles) o proporcionando las credenciales de acceso de un usuario (control de acceso basado en claves). Para mayor seguridad y flexibilidad, le recomendamos utilizar un control de acceso basado en roles de IAM. Para obtener más información, consulte [Parámetros de autorización](copy-parameters-authorization.md).
## Parámetros admitidos
Si lo prefiere, puede especificar los siguientes parámetros con COPY de Amazon EMR:
+ [Opciones de mapeo de columnas](copy-parameters-column-mapping.md)
+ [Parámetros de formato de datos](copy-parameters-data-format.md#copy-data-format-parameters)
+ [Parámetros de conversión de datos](copy-parameters-data-conversion.md)
+ [Operaciones de carga de datos](copy-parameters-data-load.md)
## Parámetros no admitidos
No puede utilizar los siguientes parámetros con COPY de Amazon EMR:
+ ENCRYPTED
+ MANIFEST
+ REGION
+ READRATIO
+ SSH
# COPY de hosts remotos (SSH)
Puede utilizar el comando COPY para cargar datos en paralelo desde uno o más alojamientos remotos, como instancias de Amazon Elastic Compute Cloud (Amazon EC2) u otros equipos. COPY se conecta a los hosts remotos mediante Secure Shell (SSH) y ejecuta los comandos en los hosts remotos para generar la salida de texto. El alojamiento remoto puede ser una instancia EC2 de Linux u otro equipo Linux o Unix configurada para aceptar conexiones SSH. Amazon Redshift puede conectarse a varios alojamientos y puede establecer varias conexiones SSH en cada alojamiento. Amazon Redshift envía un comando único a través de cada conexión para generar una salida de texto que aparecerá en la salida estándar del alojamiento, la cual Amazon Redshift leerá después como si fuese cualquier otro archivo de texto.
Utilice la cláusula FROM para especificar la clave de objeto de Amazon S3 para el archivo de manifiesto que proporciona la información que COPY utilizará para establecer las conexiones SSH y ejecutar los comandos remotos.
**Topics**
+ [Sintaxis](#copy-parameters-data-source-ssh-syntax)
+ [Ejemplos](#copy-parameters-data-source-ssh-examples)
+ [Parameters](#copy-parameters-data-source-ssh-parameters)
+ [Parámetros opcionales](#copy-parameters-data-source-ssh-optional-parms)
+ [Parámetros no admitidos](#copy-parameters-data-source-ssh-unsupported-parms)
**importante**
Si el bucket de S3 que contiene el archivo de manifiesto no se encuentra en la misma región de AWS que el clúster, debe utilizar el parámetro REGION para especificar la región en la que se encuentra el bucket.
## Sintaxis
```
FROM 's3://'ssh_manifest_file' }
authorization
SSH
| optional-parameters
```
## Ejemplos
En el siguiente ejemplo, se utiliza un archivo de manifiesto para cargar datos desde un host remoto mediante SSH.
```
copy sales
from 's3://amzn-s3-demo-bucket/ssh_manifest'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
ssh;
```
## Parameters
FROM
El origen de los datos a cargar.
's3://*copy\$1from\$1ssh\$1manifest\$1file*'
El comando COPY puede conectarse con distintos hosts mediante Secure Shell (SSH, Shell seguro) y puede crear distintas conexiones SSH a cada host. COPY ejecuta un comando a través de cada conexión al host y, luego, carga la salida en la tabla desde los comandos en paralelo. El argumento *s3://copy\$1from\$1ssh\$1manifest\$1file* especifica la clave de objeto de Amazon S3 del archivo de manifiesto que proporciona la información que COPY utiliza para establecer conexiones SSH y ejecutar los comandos remotos.
El argumento *s3://copy\$1from\$1ssh\$1manifest\$1file* debe referenciar de forma explícita un solo archivo y no puede ser un prefijo de clave. A continuación se muestra un ejemplo:
```
's3://amzn-s3-demo-bucket/ssh_manifest.txt'
```
El archivo de manifiesto es un archivo de texto con formato JSON que Amazon Redshift usa para conectarse al alojamiento. En el archivo de manifiesto, se especifican los puntos de conexión del host SSH y los comandos que se ejecutarán en los hosts para devolver datos a Amazon Redshift. De forma opcional, puede incluir la clave pública del host, el nombre de usuario de inicio de sesión y una marca obligatoria para cada entrada. En el siguiente ejemplo, se muestra un archivo de manifiesto que crea dos conexiones SSH:
```
{
"entries": [
{"endpoint":"",
"command": "",
"mandatory":true,
"publickey": "",
"username": ""},
{"endpoint":"",
"command": "",
"mandatory":true,
"publickey": "",
"username": ""}
]
}
```
El archivo de manifiesto contiene una construcción `"entries"` para cada conexión SSH. Puede tener distintas conexiones a un único host o distintas conexiones a distintos hosts. Se requieren caracteres de comillas dobles, como se muestra, para los valores y los nombres de campo. Las comillas deben ser las comillas simples (0x22), no las comillas inclinadas o “inteligentes”. El único valor que no necesita caracteres de comillas dobles es el valor booleano `true` o `false` del campo `"mandatory"`.
En la siguiente lista se describen los campos del archivo de manifiesto.
endpoint
Se trata de la dirección URL o la dirección IP del alojamiento; por ejemplo, `"ec2-111-222-333.compute-1.amazonaws.com"` o `"198.51.100.0"`.
comando
El comando que ejecutará el host para generar la salida de texto o la salida binaria en formato gzip, lzop, bzip2 o zstd. El comando puede ser cualquiera que el usuario *"host\$1user\$1name" (nombre\$1de\$1usuario\$1del\$1host)* tenga permiso para ejecutar. El comando puede ser tan sencillo como imprimir un archivo, o puede consultar una base de datos o lanzar un script. La salida (archivo de texto o archivos binarios gzip, lzop o bzip2) debe estar en un formato que el comando COPY de Amazon Redshift pueda capturar. Para obtener más información, consulte [Preparación de los datos de entrada](t_preparing-input-data.md).
publickey
(Opcional) La clave pública del host. Si se proporciona la clave pública, Amazon Redshift la usará para identificar el alojamiento. Si no se proporciona la clave pública, Amazon Redshift no intentará identificar el alojamiento. Por ejemplo, si la clave pública del host remoto es `ssh-rsa AbcCbaxxx…Example root@amazon.com`, escriba el siguiente texto en el campo de clave pública: `"AbcCbaxxx…Example"`.
mandatory
(Opcional) Una cláusula que indica si el comando COPY debe fallar en caso de que el intento de conexión falle. El valor predeterminado es `false`. Si Amazon Redshift no logra establecer al menos una conexión, el comando COPY presentará error.
nombre de usuario
(Opcional) Se trata del nombre de usuario que se utilizará para iniciar sesión en el sistema de alojamiento y ejecutar el comando remoto. El nombre de inicio de sesión del usuario debe ser el mismo que se utilizó para agregar la clave pública del clúster de Amazon Redshift al archivo de claves autorizadas del alojamiento. El nombre de usuario predeterminado es `redshift`.
Para obtener más información acerca de la creación de un archivo de manifiesto, consulte [Proceso de carga de datos](loading-data-from-remote-hosts.md#load-from-host-process).
Para utilizar COPY desde un host remoto, se debe especificar el parámetro SSH con el comando COPY. Si no se especifica el parámetro SSH, COPY supone que el archivo especificado con FROM es un archivo de datos y no se ejecutará correctamente.
Si utiliza la compresión automática, el comando COPY realiza dos operaciones de lectura de los datos, lo que significa que ejecutará el comando remoto dos veces. La primera operación de lectura se realiza para proporcionar una muestra de datos para el análisis de compresión, la segunda operación de lectura es la que carga los datos. Si ejecutar el comando remoto dos veces puede producir un problema, debe deshabilitar la compresión automática. Para deshabilitar la compresión automática, ejecute el comando COPY con el parámetro COMPUPDATE establecido en OFF. Para obtener más información, consulte [Carga de tablas con compresión automática](c_Loading_tables_auto_compress.md).
Para obtener los procedimientos detallados para utilizar COPY de SSH, consulte [Carga de datos desde hosts remotos](loading-data-from-remote-hosts.md).
*authorization*
El comando COPY necesita autorización para acceder a los datos de otro recurso de AWS, incluidos los recursos de Amazon S3, Amazon EMR, Amazon DynamoDB y Amazon EC2. Puede proporcionar esa autorización referenciando un rol de AWS Identity and Access Management (IAM) que esté adjunto al clúster (control de acceso basado en roles) o proporcionando las credenciales de acceso de un usuario (control de acceso basado en claves). Para mayor seguridad y flexibilidad, le recomendamos utilizar un control de acceso basado en roles de IAM. Para obtener más información, consulte [Parámetros de autorización](copy-parameters-authorization.md).
SSH
Una cláusula que especifica que los datos se van a cargar desde un host remoto mediante el protocolo SSH. Si especifica SSH, también debe proporcionar un archivo de manifiesto mediante el argumento [s3://copy_from_ssh_manifest_file](#copy-ssh-manifest).
Si utiliza SSH para copiar datos de un host con una dirección IP privada en una VPC remota, la VPC debe tener habilitado el direccionamiento de VPC mejorado. Para obtener más información sobre el direccionamiento de VPC mejorado, consulte el artículo sobre el [direccionamiento de VPC mejorado en Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/enhanced-vpc-routing.html)
## Parámetros opcionales
Opcionalmente, puede especificar los siguientes parámetros con COPY de SSH:
+ [Opciones de mapeo de columnas](copy-parameters-column-mapping.md)
+ [Parámetros de formato de datos](copy-parameters-data-format.md#copy-data-format-parameters)
+ [Parámetros de conversión de datos](copy-parameters-data-conversion.md)
+ [Operaciones de carga de datos](copy-parameters-data-load.md)
## Parámetros no admitidos
No puede utilizar los siguientes parámetros con COPY de SSH:
+ ENCRYPTED
+ MANIFEST
+ READRATIO
# COPY de Amazon DynamoDB
Si desea cargar datos de una tabla existente de DynamoDB, utilice la cláusula FROM para especificar el nombre de la tabla de DynamoDB.
**Topics**
+ [Sintaxis](#copy-parameters-data-source-dynamodb-syntax)
+ [Ejemplos](#copy-parameters-data-source-dynamodb-examples)
+ [Parámetros opcionales](#copy-parameters-data-source-dynamodb-optional-parms)
+ [Parámetros no admitidos](#copy-parameters-data-source-dynamodb-unsupported-parms)
**importante**
Si la tabla de DynamoDB no se encuentra en la misma región que el clúster de Amazon Redshift, debe utilizar el parámetro REGION para especificar la región en la que se encuentran los datos.
## Sintaxis
```
FROM 'dynamodb://table-name'
authorization
READRATIO ratio
| REGION [AS] 'aws_region'
| optional-parameters
```
## Ejemplos
En el siguiente ejemplo, se cargan datos de una tabla de DynamoDB.
```
copy favoritemovies from 'dynamodb://ProductCatalog'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
readratio 50;
```
### Parameters
FROM
El origen de los datos a cargar.
'dynamodb://*table-name (nombre-tabla)*'
Se trata del nombre de la tabla de DynamoDB que contiene los datos; por ejemplo, `'dynamodb://ProductCatalog'`. Para obtener detalles acerca de cómo se asignan los atributos de DynamoDB a las columnas de Amazon Redshift, consulte [Carga de datos desde una tabla de Amazon DynamoDB](t_Loading-data-from-dynamodb.md).
El nombre de una tabla de DynamoDB es único para una cuenta de AWS, que se identifica con las credenciales de acceso de AWS.
*authorization*
El comando COPY necesita autorización para acceder a los datos de otro recurso de AWS, incluidos los recursos de Amazon S3, Amazon EMR, DynamoDB y Amazon EC2. Puede proporcionar esa autorización referenciando un rol de AWS Identity and Access Management (IAM) que esté adjunto al clúster (control de acceso basado en roles) o proporcionando las credenciales de acceso de un usuario (control de acceso basado en claves). Para mayor seguridad y flexibilidad, le recomendamos utilizar un control de acceso basado en roles de IAM. Para obtener más información, consulte [Parámetros de autorización](copy-parameters-authorization.md).
READRATIO [AS] *ratio*
Se trata del porcentaje del rendimiento aprovisionado de la tabla de DynamoDB para utilizar en la carga de datos. Se requiere READRATIO para utilizar COPY de DynamoDB. No se puede utilizar con COPY de Amazon S3. Le recomendamos encarecidamente establecer la ratio en un valor menor que el rendimiento provisionado sin utilizar promedio. Los valores válidos son números enteros que forman parte del rango 1-200.
Si establece READRATIO en 100 o más permite a Amazon Redshift consumir la totalidad del rendimiento aprovisionado de la tabla de DynamoDB, lo que degrada seriamente el rendimiento de las operaciones de lectura simultáneas que se produzcan en la misma tabla durante la sesión de COPY. El tráfico de escritura no resulta afectado. Los valores superiores a 100 se permiten para solucionar problemas en situaciones raras por las que Amazon Redshift no cumple el rendimiento aprovisionado de la tabla. Si carga datos de DynamoDB en Amazon Redshift de forma continua, considere la posibilidad de organizar las tablas de DynamoDB como series temporales para separar el tráfico activo de la operación COPY.
## Parámetros opcionales
Si lo prefiere, puede especificar los siguientes parámetros con COPY de Amazon DynamoDB:
+ [Opciones de mapeo de columnas](copy-parameters-column-mapping.md)
+ Se admiten los siguientes parámetros de conversión de datos:
+ [ACCEPTANYDATE](copy-parameters-data-conversion.md#copy-acceptanydate)
+ [BLANKSASNULL](copy-parameters-data-conversion.md#copy-blanksasnull)
+ [DATEFORMAT](copy-parameters-data-conversion.md#copy-dateformat)
+ [EMPTYASNULL](copy-parameters-data-conversion.md#copy-emptyasnull)
+ [ROUNDEC](copy-parameters-data-conversion.md#copy-roundec)
+ [TIMEFORMAT](copy-parameters-data-conversion.md#copy-timeformat)
+ [TRIMBLANKS](copy-parameters-data-conversion.md#copy-trimblanks)
+ [TRUNCATECOLUMNS](copy-parameters-data-conversion.md#copy-truncatecolumns)
+ [Operaciones de carga de datos](copy-parameters-data-load.md)
## Parámetros no admitidos
No se pueden utilizar los siguientes parámetros con COPY de DynamoDB:
+ Todos los parámetros de formatos de datos
+ ESCAPE
+ FILLRECORD
+ IGNOREBLANKLINES
+ IGNOREHEADER
+ NULL
+ REMOVEQUOTES
+ ACCEPTINVCHARS
+ MANIFEST
+ ENCRYPTED
# Parámetros de autorización
El comando COPY necesita autorización para acceder a los datos de otro recurso de AWS, incluidos los recursos de Amazon S3, Amazon EMR, Amazon DynamoDB y Amazon EC2. Puede proporcionar esa autorización si hace referencia a un [rol de (IAM) de AWS Identity and Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) que esté asociado a su clúster (*role-based access control*). Puede cifrar los datos de carga en Amazon S3.
En los siguientes temas se proporcionan más detalles y ejemplos de opciones de autenticación:
+ [Permisos de IAM para COPY, UNLOAD y CREATE LIBRARY](copy-usage_notes-access-permissions.md#copy-usage_notes-iam-permissions)
+ [Control de acceso con base en roles](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based)
+ [Control de acceso basado en claves](copy-usage_notes-access-permissions.md#copy-usage_notes-access-key-based)
Utilice una de las siguientes opciones para brindar autorización al comando COPY:
+ [Uso del parámetro IAM\$1ROLE](#copy-iam-role)Parámetro de
+ [Uso de los parámetros ACCESS\$1KEY\$1ID y SECRET\$1ACCESS\$1KEY](#copy-access-key-id)Parámetros
+ [Uso del parámetro CREDENTIALS](#copy-credentials)Cláusula
## Uso del parámetro IAM\$1ROLE
### IAM\$1ROLE
Utilice la palabra clave predeterminada para que Amazon Redshift utilice el rol de IAM configurado como predeterminado y asociado al clúster cuando se ejecuta el comando COPY.
Utilice el nombre de recurso de Amazon (ARN), de un rol de IAM que el clúster utiliza para la autenticación y la autorización. Si especifica IAM\$1ROLE, no puede utilizar ACCESS\$1KEY\$1ID, SECRET\$1ACCESS\$1KEY, SESSION\$1TOKEN ni CREDENTIALS.
A continuación, se muestra la sintaxis del parámetro IAM\$1ROLE.
```
IAM_ROLE { default | 'arn:aws:iam:::role/' }
```
Para obtener más información, consulte [Control de acceso con base en roles](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based).
## Uso de los parámetros ACCESS\$1KEY\$1ID y SECRET\$1ACCESS\$1KEY
### ACCESS\$1KEY\$1ID, SECRET\$1ACCESS\$1KEY
No se recomienda este método de autorización.
**nota**
En lugar de proporcionar credenciales de acceso como texto sin formato, le recomendamos encarecidamente utilizar una autenticación basada en roles mediante la especificación del parámetro IAM\$1ROLE. Para obtener más información, consulte [Control de acceso con base en roles](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based).
### SESSION\$1TOKEN
El token de sesión para utilizar con credenciales de acceso temporales. Cuando se especifica SESSION\$1TOKEN, también debe utilizar ACCESS\$1KEY\$1ID y SECRET\$1ACCESS\$1KEY para proporcionar credenciales temporales de clave de acceso. Si especifica SESSION\$1TOKEN, no puede utilizar IAM\$1ROLE ni CREDENTIALS. Para obtener más información, consulte [Credenciales de seguridad temporales](copy-usage_notes-access-permissions.md#r_copy-temporary-security-credentials) en la Guía del usuario de IAM.
**nota**
En lugar de crear credenciales de seguridad temporales, le recomendamos encarecidamente utilizar una autenticación basada en roles. Cuando brinda autorización mediante un rol de IAM, Amazon Redshift crea de forma automática credenciales temporales de usuario para cada sesión. Para obtener más información, consulte [Control de acceso con base en roles](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based).
A continuación se muestra la sintaxis del parámetro SESSION\$1TOKEN con los parámetros ACCESS\$1KEY\$1ID y SECRET\$1ACCESS\$1KEY.
```
ACCESS_KEY_ID ''
SECRET_ACCESS_KEY ''
SESSION_TOKEN '';
```
Si especifica SESSION\$1TOKEN, no puede utilizar CREDENTIALS ni IAM\$1ROLE.
## Uso del parámetro CREDENTIALS
### CREDENTIALS
Se trata de una cláusula que indica el método que el clúster utilizará cuando obtenga acceso a otros recursos de AWS que contienen archivos de datos o archivos de manifiesto. No puede utilizar el parámetro CREDENTIALS con IAM\$1ROLE ni con ACCESS\$1KEY\$1ID y SECRET\$1ACCESS\$1KEY.
A continuación, se muestra la sintaxis del parámetro CREDENTIALS.
```
[WITH] CREDENTIALS [AS] 'credentials-args'
```
**nota**
Para mayor flexibilidad, recomendamos utilizar el parámetro [IAM\$1ROLE](#copy-iam-role-iam) en lugar del parámetro CREDENTIALS.
De manera opcional, si se usa el parámetro [ENCRYPTED](copy-parameters-data-source-s3.md#copy-encrypted), la cadena *credentials-args (credenciales-argumentos)* también proporciona la clave de cifrado.
La cadena *credentials-args* distingue entre mayúsculas y minúsculas y no debe contener espacios.
Las palabras clave WITH y AS son opcionales y se ignoran.
Puede especificar [role-based access control](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based.phrase) o [key-based access control](copy-usage_notes-access-permissions.md#copy-usage_notes-access-key-based.phrase). En ambos casos, el rol o el usuario de IAM deben tener los permisos necesarios para acceder a los recursos de AWS especificados. Para obtener más información, consulte [Permisos de IAM para COPY, UNLOAD y CREATE LIBRARY](copy-usage_notes-access-permissions.md#copy-usage_notes-iam-permissions).
**nota**
Para salvaguardar las credenciales de AWS y proteger la información confidencial, le recomendamos encarecidamente utilizar un control de acceso basado en roles.
Para especificar un control de acceso basado en funciones, proporcione la cadena *credentials-args (credenciales-argumentos)* en el siguiente formato.
```
'aws_iam_role=arn:aws:iam:::role/'
```
Para usar las credenciales de token temporales, debe proporcionar el ID de clave de acceso temporal, la clave de acceso secreta temporal y el token temporal. La cadena *credentials-args* tiene el siguiente formato.
```
CREDENTIALS
'aws_access_key_id=;aws_secret_access_key=;token='
```
Un comando COPY que utilice un control de acceso basado en roles con credenciales temporales se parecería a la siguiente instrucción de ejemplo:
```
COPY customer FROM 's3://amzn-s3-demo-bucket/mydata'
CREDENTIALS
'aws_access_key_id=;aws_secret_access_key=;token='
```
Para obtener más información, consulte [Credenciales de seguridad temporales](copy-usage_notes-access-permissions.md#r_copy-temporary-security-credentials).
Si se utiliza el parámetro [ENCRYPTED](copy-parameters-data-source-s3.md#copy-encrypted), la cadena *credentials-args* tiene el siguiente formato, donde ** es el valor de la clave raíz que se utilizó para cifrar los archivos.
```
CREDENTIALS
';master_symmetric_key='
```
Un comando COPY que utilice un control de acceso basado en roles con una clave de cifrado se parecería a la siguiente instrucción de ejemplo:
```
COPY customer FROM 's3://amzn-s3-demo-bucket/mydata'
CREDENTIALS
'aws_iam_role=arn:aws:iam:::role/;master_symmetric_key='
```
# Opciones de mapeo de columnas
De manera predeterminada, COPY inserta los valores en las columnas de la tabla de destino en el mismo orden que aparecen los campos en los archivos de datos. Si el orden de columnas predeterminado no funcionará, puede especificar una lista de columnas o utilizar las expresiones JSONPath para asignar los campos de datos de origen a las columnas de destino.
+ [Column List](#copy-column-list)
+ [JSONPaths File](#copy-column-mapping-jsonpaths)
## Lista de columnas
Puede especificar una lista de nombres de columnas separada por comas para cargar los campos de datos de origen en columnas de destino específicas. Las columnas pueden estar en cualquier orden en la instrucción COPY, pero, cuando se cargan desde archivos sin formato, como en un bucket de Amazon S3, el orden debe coincidir con el de los datos de origen.
Cuando se realiza la carga desde una tabla de Amazon DynamoDB, el orden no importa. El comando COPY establece una correspondencia entre los nombres de atributos de los elementos recuperados de la tabla de DynamoDB y los nombres de columnas de una tabla de Amazon Redshift. Para obtener más información, consulte [Carga de datos desde una tabla de Amazon DynamoDB](t_Loading-data-from-dynamodb.md)
El formato para una lista de columnas es el siguiente.
```
COPY tablename (column1 [,column2, ...])
```
Si una columna de la tabla de destino se omite de la lista de columnas, COPY carga la expresión [DEFAULT](r_CREATE_TABLE_NEW.md#create-table-default) de la columna de destino.
Si la columna de destino no tiene un valor predeterminado, COPY intenta cargar NULL.
Si COPY prueba asignar NULL a una columna que está definida como NOT NULL, el comando COPY falla.
Si se incluye una columna [IDENTITY](r_CREATE_TABLE_NEW.md#identity-clause) en la lista de columnas, también se debe especificar [EXPLICIT_IDS](copy-parameters-data-conversion.md#copy-explicit-ids). Si se omite una columna IDENTITY, no se puede especificar EXPLICIT\$1IDS. Si no se especifica una lista de columnas, el comando se comporta como si se especificará una lista de columnas por orden completa, con la omisión de columnas IDENTITY si tampoco se especificó EXPLICIT\$1IDS.
Si una columna se define con GENERATED BY DEFAULT AS IDENTITY, se puede copiar. Los valores se generan o se actualizan con los que se proporcionan. La opción EXPLICIT\$1IDS no es obligatoria. COPY no actualiza el límite máximo de la identidad. Para obtener más información, consulte [GENERATED BY DEFAULT AS IDENTITY](r_CREATE_TABLE_NEW.md#identity-generated-bydefault-clause).
## Archivo JSONPaths
Cuando se realiza una carga desde archivos de datos en formatos JSON o Avro, COPY asigna de forma automática los elementos de datos en los datos de origen Avro o JSON a las columnas de la tabla de destino. Logra esto al hacer coincidir los nombres de los campos del esquema de Avro con los nombres de las columnas de la lista de columnas o la tabla de destino.
En algunos casos, los nombres de las columnas y los nombres de los campos no coinciden, o bien, es necesario asignarlos a niveles más profundos en la jerarquía de los datos. En estos casos, puede utilizar un archivo JSONPaths para asignar de forma explícita los elementos de datos JSON o Avro a las columnas.
Para obtener más información, consulte [Archivo JSONPaths](copy-parameters-data-format.md#copy-json-jsonpaths).
# Parámetros de formato de datos
De manera predeterminada, el comando COPY espera que los datos de origen estén en texto UTF-8 delimitado por caracteres. El delimitador predeterminado es el carácter de barra vertical ( \$1 ). Si los datos de origen están en otro formato, utilice los siguientes parámetros para especificar el formato de datos:
+ [FORMAT](#copy-format)
+ [CSV](#copy-csv)
+ [DELIMITER](#copy-delimiter)
+ [FIXEDWIDTH](#copy-fixedwidth)
+ [SHAPEFILE](#copy-shapefile)
+ [AVRO](#copy-avro)
+ [JSON format for COPY](#copy-json)
+ [PARQUET](#copy-parquet)
+ [ORC](#copy-orc)
Además de los formatos de datos estándar, COPY admite los siguientes formatos de datos en columnas para COPY de Amazon S3:
+ [ORC](#copy-orc)
+ [PARQUET](#copy-parquet)
Existen ciertas restricciones para poder usar el comando COPY con el formato de columnas. Para obtener más información, consulte [Uso de COPY con formatos de datos de columnas](copy-usage_notes-copy-from-columnar.md). Parámetros de formato de datos
FORMAT [AS]
(Opcional) Identifica palabras clave de los formatos de datos. Los argumentos FORMAT se describen a continuación.
CSV [ QUOTE [AS] *'quote\$1character'* ]
Permite el uso del formato CSV en los datos de entrada. Para aplicar escape de forma automática a los delimitadores, los caracteres de línea nueva y los retornos de carro, encierre el campo con el carácter especificado por el parámetro QUOTE. El carácter de comilla predeterminado es el de comilla doble ( " ). Cuando utilice el carácter de comilla dentro del campo, aplique escape al carácter con un carácter de comilla adicional. Por ejemplo, si los caracteres de comillas son comillas dobles, para insertar la cadena `A "quoted" word`, el archivo de entrada debe incluir la cadena `"A ""quoted"" word"`. Cuando se utiliza el parámetro CSV, el delimitador predeterminado es una coma ( , ). Puede especificar un delimitador diferente con el parámetro DELIMITER.
Cuando se encierra un campo entre comillas, se ignora el espacio en blanco entre los delimitadores y los caracteres de comillas. Si el delimitador es un carácter de espacio en blanco, como un tabulador, el delimitador no se trata como un espacio en blanco.
CSV no puede utilizarse con FIXEDWIDTH, REMOVEQUOTES ni ESCAPE.
QUOTE [AS] *'quote\$1character'*
Opcional. Especifica el carácter que se utilizará como carácter de comilla cuando se utilice el parámetro CSV. El carácter predeterminado es una comilla doble ( " ). Si utiliza el parámetro QUOTE para definir un carácter de comilla distinto al de comilla doble, no es necesario que aplique escape a las comillas dobles dentro del campo. El parámetro QUOTE solo puede utilizarse con el parámetro CSV. La palabra clave AS es opcional.
DELIMITER [AS] ['*delimiter\$1char*']
Especifica caracteres que se utilizan para separar campos en el archivo de entrada, como un carácter de barra vertical (`|`), una coma (`,`), una tabulación (`\t`) o varios caracteres, como `|~|`. Se admiten los caracteres no imprimibles. Los caracteres también se pueden representar en formato octal como unidades de código UTF-8. Para el formato octal, utilice el formato “\$1ddd”, donde “d” es un dígito octal (de 0 a 7). El delimitador predeterminado es un carácter de barra vertical (`|`), a menos que se utilice el parámetro CSV, en cuyo caso el delimitador predeterminado es una coma (`,`). La palabra clave AS es opcional. DELIMITER no se puede utilizar con FIXEDWIDTH.
FIXEDWIDTH '*fixedwidth\$1spec*'
Carga los datos de un archivo en el que el ancho de cada columna tiene una longitud fija, en lugar de que las columnas estén separadas por un delimitador. La cadena *fixedwidth\$1spec (especificación\$1de\$1ancho\$1fijo)* especifica una etiqueta de columnas definida por el usuario y el ancho de columnas. La etiqueta de columnas puede ser una cadena de texto o un número entero, según lo que decida el usuario. La etiqueta de columnas no tiene relación con el nombre de las columnas. El orden de los pares etiqueta/ancho debe coincidir con el orden de las columnas de la tabla de forma exacta. FIXEDWIDTH no se puede utilizar con CSV ni DELIMITER. En Amazon Redshift, la longitud de las columnas CHAR y VARCHAR se expresa en bytes, por lo que debe asegurarse de que el ancho de la columna que especifique se adapte a la longitud binaria de caracteres multibyte cuando prepare el archivo que se cargará. Para obtener más información, consulte [Tipos de caracteres](r_Character_types.md).
A continuación, se muestra el formato para *fixedwidth\$1spec*:
```
'colLabel1:colWidth1,colLabel:colWidth2, ...'
```
SHAPEFILE [ SIMPLIFY [AUTO] [*'tolerance'*] ]
Permite el uso del formato SHAPEFILE en los datos de entrada. De manera predeterminada, la primera columna del shapefile es una columna `GEOMETRY` o `IDENTITY`. Todas las columnas posteriores tienen el orden especificado en el shapefile.
SHAPEFILE no puede utilizarse con FIXEDWIDTH, REMOVEQUOTES ni ESCAPE.
Para utilizar objetos `GEOGRAPHY` con `COPY FROM SHAPEFILE`, primero captúrelos en una columna `GEOMETRY` y, a continuación, convierta los objetos en objetos `GEOGRAPHY`.
SIMPLIFY [*tolerance*]
(Opcional) Simplifica toda la geometría durante el proceso de ingesta mediante el algoritmo de Ramer-Douglas-Peucker y la tolerancia dada.
SIMPLIFY AUTO [*tolerance*]
(Opcional) Simplifica solo la geometría que sea más grandes que el tamaño máximo de geometría. Esta simplificación utiliza el algoritmo de Ramer-Douglas-Peucker y la tolerancia calculada de forma automática si no supera la tolerancia especificada. Este algoritmo calcula el tamaño para almacenar objetos en el marco de la tolerancia especificada. El valor *tolerance* es opcional.
Para ver ejemplos de carga de shapefiles, consulte [Carga de un shapefile en Amazon Redshift](r_COPY_command_examples.md#copy-example-spatial-copy-shapefile).
AVRO [AS] '*avro\$1option*'
Especifica que los datos de origen estén en formato de Avro.
El formato de Avro se admite para COPY de estos servicios y protocolos:
+ Amazon S3
+ Amazon EMR
+ Hosts remotos (SSH)
Avro no es compatible con COPY de DynamoDB.
Avro es un protocolo de serialización de datos. Un archivo de origen Avro incluye un esquema que define la estructura de los datos. El tipo de esquema de Avro debe ser `record`. COPY acepta archivos Avro creados mediante el códec predeterminado sin comprimir como también los códecs de compresión `deflate` y `snappy`. Para obtener más información acerca de Avro, visite [Apache Avro](https://avro.apache.org/).
Los valores válidos para *avro\$1option* son los siguientes:
+ `'auto'`
+ `'auto ignorecase'`
+ `'s3://jsonpaths_file'`
El valor predeterminado es `'auto'`.
COPY asigna de forma automática los elementos de datos en los datos de origen Avro a las columnas de la tabla de destino. Logra esto al hacer coincidir los nombres de los campos del esquema de Avro con los nombres de las columnas de la tabla de destino. La coincidencia distingue entre letras mayúsculas y minúsculas en `'auto'`, y no distingue entre letras mayúsculas y minúsculas en `'auto ignorecase'`.
Los nombres de las columnas de las tablas de Amazon Redshift están siempre en minúsculas; por lo tanto, cuando utilice la opción `'auto'`, los nombres de campos coincidentes también deben estar en minúsculas. Si los nombres de los campos no están en minúsculas por completo, puede utilizar la opción `'auto ignorecase'`. Con el argumento predeterminado `'auto'`, COPY solo reconoce el primer nivel de campos o los *campos externos* de la estructura.
Para asignar explícitamente nombres de columnas a nombres de campos de Avro, puede utilizar [Archivo JSONPaths](#copy-json-jsonpaths).
De manera predeterminada, COPY intenta hacer coincidir todas las columnas de la tabla de destino con los nombres de campos de Avro. Si lo desea, puede especificar una lista de columnas para cargar un subconjunto de las columnas. Si una columna de la tabla de destino se omite de la lista de columnas, COPY carga la expresión [DEFAULT](r_CREATE_TABLE_NEW.md#create-table-default) de la columna de destino. Si la columna de destino no tiene un valor predeterminado, COPY intenta cargar NULL. Si se incluye una columna en la lista de columnas y COPY no encuentra un campo coincidente en los datos Avro, COPY intenta cargar NULL en la columna.
Si COPY prueba asignar NULL a una columna que está definida como NOT NULL, el comando COPY falla.
**Esquema de Avro**
Un archivo de datos de origen Avro incluye un esquema que define la estructura de los datos. COPY lee el esquema que forma parte del archivo de datos de origen Avro para asignar elementos de datos a las columnas de la tabla de destino. En el siguiente ejemplo, se muestra un esquema de Avro.
```
{
"name": "person",
"type": "record",
"fields": [
{"name": "id", "type": "int"},
{"name": "guid", "type": "string"},
{"name": "name", "type": "string"},
{"name": "address", "type": "string"}]
}
```
El esquema de Avro se define mediante el formato JSON. El objeto JSON de nivel superior contiene tres pares de nombre-valor con los nombres o las *claves*: `"name"`, `"type"` y `"fields"`.
Los pares de claves `"fields"` con una matriz de objetos que define el nombre y el tipo de datos de cada campo en la estructura de datos. De manera predeterminada, COPY automáticamente hace coincidir los nombres de los campos con los nombres de las columnas. Los nombres de las columnas están siempre en minúsculas, por lo que los nombres de los campos coincidentes también deben estar en minúsculas, a menos que se especifique la opción `‘auto ignorecase’`. Cualquier nombre de campo que no coincida con el nombre de una columna se ignora. El orden no es importante. En el ejemplo anterior, COPY asigna `id`, `guid`, `name` y `address` a los nombres de columnas.
Con el argumento predeterminado `'auto'`, COPY hace coincidir con las columnas solo los objetos de primer nivel. Para asignar a niveles más profundos en el esquema, o si los nombres de los campos y los de las columnas no coinciden, utilice un archivo JSONPaths para definir el mapeo. Para obtener más información, consulte [Archivo JSONPaths](#copy-json-jsonpaths).
Si el valor asociado a una clave es un tipo complejo de datos Avro, como byte, matriz, registro, mapeo o enlace, COPY carga el valor como una cadena. Aquí, la cadena es la representación JSON de los datos. COPY carga los tipos de datos enum de Avro como cadenas, donde el contenido es el nombre del tipo. Para ver un ejemplo, consulta [COPY de formato JSON](copy-usage_notes-copy-from-json.md).
El tamaño máximo del encabezado del archivo de Avro, incluidos el esquema y los metadatos del archivo, es de 1 MB.
El tamaño máximo de un solo bloque de datos de Avro es de 4 MB. Este es distinto al tamaño máximo de filas. Si se supera el tamaño máximo de un bloque de datos de Avro individual, aunque el tamaño de filas obtenido sea menor al límite de tamaño de filas de 4 MB, el comando COPY falla.
Cuando se calcula el tamaño de las filas, Amazon Redshift cuenta de forma interna los caracteres de barra vertical ( \$1 ) dos veces. Si los datos de entrada contienen un número muy grande de caracteres de barra vertical, es posible que el tamaño de filas supere los 4 MB, aunque el bloque de datos sea menor a 4 MB.
JSON [AS] '*json\$1option (opción\$1json)*'
Los datos de origen están en formato JSON.
El formato JSON se admite para COPY de estos servicios y protocolos:
+ Amazon S3
+ COPY de Amazon EMR
+ COPY de SSH
JSON no es compatible con COPY de DynamoDB.
Los valores válidos para *json\$1option* son los siguientes:
+ `'auto'`
+ `'auto ignorecase'`
+ `'s3://jsonpaths_file'`
+ `'noshred'`
El valor predeterminado es `'auto'`. Amazon Redshift no fragmenta los atributos de las estructuras JSON en varias columnas mientras carga un documento JSON.
De manera predeterminada, COPY intenta hacer coincidir todas las columnas de la tabla de destino con las claves de nombres de campos JSON. Si lo desea, puede especificar una lista de columnas para cargar un subconjunto de las columnas. Si las claves de los nombres de campos JSON no están en minúsculas por completo, puede utilizar la opción `'auto ignorecase'` o [Archivo JSONPaths](#copy-json-jsonpaths) para asignar de forma explícita los nombres de las columnas a las claves de los nombres de campos JSON.
Si una columna de la tabla de destino se omite de la lista de columnas, COPY carga la expresión [DEFAULT](r_CREATE_TABLE_NEW.md#create-table-default) de la columna de destino. Si la columna de destino no tiene un valor predeterminado, COPY intenta cargar NULL. Si se incluye una columna en la lista de columnas y COPY no encuentra un campo coincidente entre los datos JSON, COPY intenta cargar NULL en la columna.
Si COPY prueba asignar NULL a una columna que está definida como NOT NULL, el comando COPY falla.
COPY asigna los elementos de datos en los datos de origen JSON a las columnas de la tabla de destino. Logra esto al hacer coincidir las *claves de objetos*, o los nombres, en los pares de nombre-valor de origen con los nombres de las columnas de la tabla de destino.
Consulte los siguientes detalles acerca de cada valor *json\$1option*:
'auto'
Con esta opción, para la coincidencia, se distingue letras entre mayúsculas y minúsculas. Los nombres de las columnas de las tablas de Amazon Redshift están siempre en minúsculas; por lo tanto, cuando utilice la opción `'auto'`, los nombres de campos JSON coincidentes también deben estar en minúsculas.
'auto ignorecase'
Con esta opción, para la coincidencia, no se distingue letras entre mayúsculas y minúsculas. Los nombres de las columnas de las tablas de Amazon Redshift están siempre en minúsculas; por lo tanto, cuando utilice la opción `'auto ignorecase'`, los nombres de campos JSON correspondientes pueden estar en minúsculas, mayúsculas, en minúsculas o en mayúsculas y minúsculas.
's3://*jsonpaths\$1file*'
Con esta opción, COPY utiliza el archivo JSONPaths mencionado para asignar los elementos de datos en los datos de origen JSON a las columnas de la tabla de destino. El argumento *`s3://jsonpaths_file`* debe ser una clave de objeto de Amazon S3 que referencie de forma explícita un solo archivo. Un ejemplo es . `'s3://amzn-s3-demo-bucket/jsonpaths.txt`'. El argumento no puede ser un prefijo de clave. Para obtener más información acerca del uso de un archivo JSONPaths, consulte [Archivo JSONPaths](#copy-json-jsonpaths).
En algunos casos, el archivo especificado por `jsonpaths_file` tiene el mismo prefijo que la ruta especificada por `copy_from_s3_objectpath` para los archivos de datos. En tal caso, COPY lee el archivo JSONPaths como un archivo de datos y devuelve errores. Por ejemplo, supongamos que los archivos de datos utilizan la ruta de objeto `s3://amzn-s3-demo-bucket/my_data.json`, y el archivo JSONPaths es `s3://amzn-s3-demo-bucket/my_data.jsonpaths`. En este caso, COPY intenta cargar `my_data.jsonpaths` como un archivo de datos.
'noshred'
Con esta opción, Amazon Redshift no fragmenta los atributos de las estructuras JSON en varias columnas mientras carga un documento JSON.
## Archivo de datos JSON
El archivo de datos JSON contiene un conjunto de objetos o matrices. COPY carga cada objeto o matriz JSON en una fila de la tabla de destino. Cada objeto o matriz correspondiente a una fila debe ser una estructura independiente en el nivel raíz, es decir, no debe ser miembro de otra estructura JSON.
Un *objeto* JSON comienza y termina con llaves ( \$1 \$1 ), y contiene una colección de pares de nombre-valor desordenada. Cada valor y nombre de los pares están separados por dos puntos y los pares están separados por comas. De manera predeterminada, la *clave de objeto*, o el nombre, en los pares de nombre-valor debe coincidir con el nombre de la columna correspondiente en la tabla. Los nombres de las columnas de las tablas de Amazon Redshift están siempre en minúsculas; por lo tanto, las claves de los nombres de los campos JSON coincidentes también deben estar en minúsculas. Si los nombres de las columnas y las claves JSON no coinciden, utilice [Archivo JSONPaths](#copy-json-jsonpaths) para asignar de forma explícita las columnas a las claves.
El orden de los objetos JSON no importa. Cualquier nombre que no coincida con el nombre de una columna se ignora. A continuación, se muestra la estructura de un objeto JSON simple.
```
{
"column1": "value1",
"column2": value2,
"notacolumn" : "ignore this value"
}
```
Una *matriz* JSON comienza y termina con corchetes ( [ ] ) y contiene una colección ordenada de valores separados por comas. Si los archivos de datos utilizan matrices, debe especificar un archivo JSONPaths para hacer coincidir los valores con las columnas. A continuación, se muestra la estructura de una matriz JSON simple.
```
["value1", value2]
```
El JSON debe tener un formato correcto. Por ejemplo, los objetos o las matrices no pueden separarse con comas o cualquier otro carácter, a excepción de un espacio en blanco. Las cadenas se deben encerrar entre caracteres de comilla doble. Los caracteres de comillas deben ser las comillas comunes (0x22), no las inclinadas ni las "inteligentes".
El tamaño máximo de un objeto o matriz JSON individual, incluidas las llaves o los corchetes, es de 4 MB. Este es distinto al tamaño máximo de filas. Si se supera el tamaño máximo de un objeto o matriz JSON individual, aunque el tamaño de filas obtenido sea menor al límite de tamaño de filas de 4 MB, el comando COPY falla.
Cuando se calcula el tamaño de las filas, Amazon Redshift cuenta de forma interna los caracteres de barra vertical ( \$1 ) dos veces. Si los datos de entrada contienen un número muy grande de caracteres de barra vertical, es posible que el tamaño de filas supere los 4 MB, aunque el tamaño del objeto sea menor a 4 MB.
COPY carga `\n` como un carácter de línea nueva y `\t` como un tabulador. Para cargar una barra inversa, aplique escape con una barra inversa ( `\\` ).
COPY busca el origen de JSON especificado para obtener un objeto o matriz JSON válido con un formato correcto. Si COPY encuentra caracteres que no sean de espacios en blanco antes de localizar una estructura JSON utilizable o entre objetos o matrices JSON válidos, COPY devuelve un error para cada instancia. Estos errores cuentan para el recuento de errores MAXERROR. Cuando el recuento de errores iguala o supera MAXERROR, COPY falla.
Por cada error, Amazon Redshift registra una fila en la tabla de sistema STL\$1LOAD\$1ERRORS. La columna LINE\$1NUMBER registra la última línea del objeto JSON que provocó el error.
Si se especifica IGNOREHEADER, COPY ignora el número de líneas especificado en los datos JSON. Los caracteres de línea nueva en los datos JSON siempre se cuentan para los cálculos IGNOREHEADER.
De manera predeterminada, COPY carga las cadenas vacías como campos vacíos. Si se especifica EMPTYASNULL, COPY carga las cadenas vacías para los campos CHAR y VARCHAR como NULL. Las cadenas vacías para otros tipos de datos, como INT, siempre se cargan con NULL.
Las siguientes opciones no son compatibles con JSON:
+ CSV
+ DELIMITER
+ ESCAPE
+ FILLRECORD
+ FIXEDWIDTH
+ IGNOREBLANKLINES
+ NULL AS
+ READRATIO
+ REMOVEQUOTES
Para obtener más información, consulte [COPY de formato JSON](copy-usage_notes-copy-from-json.md). Para obtener más información acerca de las estructuras de datos JSON, visite [www.json.org](https://www.json.org/).
## Archivo JSONPaths
Si el usuario carga datos de origen Avro o en formato JSON, de manera predeterminada, COPY asigna los elementos de datos de primer nivel en los datos de origen a las columnas de la tabla de destino. Logra esto al hacer coincidir cada nombre, o clave de objeto, en un par de nombre-valor con el nombre de una columna de la tabla de destino.
Si los nombres de las columnas y las claves de objeto no coinciden, o si desea asignar a niveles más profundos en la jerarquía de datos, puede utilizar un archivo JSONPaths para asignar de forma explícita elementos de datos JSON o de Avro a las columnas. El archivo JSONPaths asigna los elementos de datos JSON a las columnas haciendo coincidir el orden de columnas en la lista de columnas o tabla de destino.
El archivo JSONPaths debe contener solo un objeto JSON (no una matriz). El objeto JSON es un par de nombre-valor. La *clave de objeto*, que es el nombre del par de nombre-valor, debe ser `"jsonpaths"`. El *valor* del par de nombre-valor es una matriz de *expresiones JSONPath*. Cada expresión JSONPath hace referencia a un elemento individual en la jerarquía de datos JSON o el esquema de Avro, de forma parecida al modo en que una expresión XPath hace referencia a los elementos de un documento XML. Para obtener más información, consulte [Expresiones JSONPath](#copy-json-jsonpath-expressions).
Para utilizar un archivo JSONPaths, agregue la palabra clave AVRO o JSON al comando COPY. Especifique el nombre del bucket de S3 y la ruta de objeto del archivo JSONPaths con el siguiente formato.
```
COPY tablename
FROM 'data_source'
CREDENTIALS 'credentials-args'
FORMAT AS { AVRO | JSON } 's3://jsonpaths_file';
```
El valor `s3://jsonpaths_file` debe ser una clave de objeto de Amazon S3 que referencie de forma explícita un solo archivo, como `'s3://amzn-s3-demo-bucket/jsonpaths.txt'`. No puede ser un prefijo de clave.
En algunos casos, si la carga se realiza desde Amazon S3, el archivo especificado por `jsonpaths_file` tiene el mismo prefijo que la ruta especificada por `copy_from_s3_objectpath` para los archivos de datos. En tal caso, COPY lee el archivo JSONPaths como un archivo de datos y devuelve errores. Por ejemplo, supongamos que los archivos de datos utilizan la ruta de objeto `s3://amzn-s3-demo-bucket/my_data.json`, y el archivo JSONPaths es `s3://amzn-s3-demo-bucket/my_data.jsonpaths`. En este caso, COPY intenta cargar `my_data.jsonpaths` como un archivo de datos.
Si el nombre de clave es una cadena distinta de `"jsonpaths"`, el comando COPY no devuelve un error, pero omite *jsonpaths\$1file* y utiliza el argumento `'auto'` en su lugar.
Si sucede alguna de las siguientes situaciones, el comando COPY falla:
+ El JSON tiene un formato incorrecto.
+ Existe más de un objeto JSON.
+ Algún carácter a excepción del espacio en blanco existe fuera del objeto.
+ Un elemento de la matriz es una cadena vacía o no es una cadena.
MAXERROR no se aplica al archivo JSONPaths.
El archivo JSONPaths no debe cifrarse aunque la opción [ENCRYPTED](copy-parameters-data-source-s3.md#copy-encrypted) esté especificada.
Para obtener más información, consulte [COPY de formato JSON](copy-usage_notes-copy-from-json.md).
## Expresiones JSONPath
El archivo JSONPaths utiliza expresiones JSONPath para asignar los campos de datos a las columnas de destino. Cada expresión JSONPath corresponde a una columna de la tabla de destino de Amazon Redshift. El orden de los elementos de la matriz JSONPath debe coincidir con el orden de las columnas de la tabla de destino o de la lista de columnas, si se utiliza una.
Se requieren caracteres de comillas dobles, como se muestra, para los valores y los nombres de campo. Las comillas deben ser las comillas simples (0x22), no las comillas inclinadas o “inteligentes”.
Si un elemento de objeto indicado por una expresión JSONPath no se encuentra en los datos JSON, COPY intenta cargar un valor NULL. Si el objeto indicado tiene un formato incorrecto, COPY devuelve un error de carga.
Si un elemento de la matriz al que se hace referencia en la expresión JSONPath no se encuentra en los datos de Avro o JSON, COPY registra el siguiente error: `Invalid JSONPath format: Not an array or index out of range.` Elimine de JSONPaths todos los elementos de la matriz que no existan en los datos de origen y verifique que las matrices de los datos de origen tienen el formato correcto.
Las expresiones JSONPath pueden utilizar notaciones con corchetes o con puntos, pero las notaciones no se pueden combinar. En el siguiente ejemplo, se muestran expresiones JSONPath que utilizan la notación con corchetes.
```
{
"jsonpaths": [
"$['venuename']",
"$['venuecity']",
"$['venuestate']",
"$['venueseats']"
]
}
```
En el siguiente ejemplo, se muestran expresiones JSONPath que utilizan la notación con puntos.
```
{
"jsonpaths": [
"$.venuename",
"$.venuecity",
"$.venuestate",
"$.venueseats"
]
}
```
En el contexto de la sintaxis de COPY de Amazon Redshift, una expresión JSONPath debe especificar la ruta explícita a un elemento de nombre único en una estructura de datos jerárquica de Avro o JSON. Amazon Redshift no admite ningún elemento de JSONPath, como caracteres comodín o expresiones de filtro, que pueda resolverse como una ruta ambigua o como varios elementos de nombre.
Para obtener más información, consulte [COPY de formato JSON](copy-usage_notes-copy-from-json.md).
## Uso de JSONPaths con datos de Avro
En el siguiente ejemplo, se muestra un esquema de Avro con varios niveles.
```
{
"name": "person",
"type": "record",
"fields": [
{"name": "id", "type": "int"},
{"name": "guid", "type": "string"},
{"name": "isActive", "type": "boolean"},
{"name": "age", "type": "int"},
{"name": "name", "type": "string"},
{"name": "address", "type": "string"},
{"name": "latitude", "type": "double"},
{"name": "longitude", "type": "double"},
{
"name": "tags",
"type": {
"type" : "array",
"name" : "inner_tags",
"items" : "string"
}
},
{
"name": "friends",
"type": {
"type" : "array",
"name" : "inner_friends",
"items" : {
"name" : "friends_record",
"type" : "record",
"fields" : [
{"name" : "id", "type" : "int"},
{"name" : "name", "type" : "string"}
]
}
}
},
{"name": "randomArrayItem", "type": "string"}
]
}
```
En el siguiente ejemplo, se muestra un archivo JSONPaths que utiliza las expresiones AvroPath para hacer referencia al esquema anterior.
```
{
"jsonpaths": [
"$.id",
"$.guid",
"$.address",
"$.friends[0].id"
]
}
```
El ejemplo de JSONPaths incluye los siguientes elementos:
jsonpaths
El nombre del objeto JSON que contiene las expresiones AvroPath.
[ … ]
Los corchetes encierran la matriz JSON que contiene los elementos de la ruta.
\$1
El símbolo de dólar hace referencia al elemento raíz en el esquema de Avro, que es la matriz `"fields"`.
"\$1.id",
El destino de la expresión AvroPath. En esta instancia, el destino es el elemento de la matriz `"fields"` con el nombre `"id"`. Las expresiones están separadas por comas.
"\$1.friends[0].id"
Los corchetes indican un índice de matriz. Las expresiones JSONPath utilizan una indexación de base cero, por lo que esta expresión hace referencia al primer elemento de la matriz `"friends"` con el nombre `"id"`.
La sintaxis del esquema de Avro requiere el uso de *campos internos* para definir la estructura de registro y los tipos de datos de matriz. Las expresiones AvroPath ignoran los campos internos. Por ejemplo, el campo `"friends"` define una matriz denominada `"inner_friends"`, que a su vez define un registro denominado `"friends_record"`. La expresión AvroPath que hace referencia al campo `"id"` puede ignorar los campos adicionales para hacer referencia directamente al campo de destino. Las siguientes expresiones AvroPath hacen referencia a los dos campos que pertenecen a la matriz `"friends"`.
```
"$.friends[0].id"
"$.friends[0].name"
```
## Parámetros de formatos de datos en columnas
Además de los formatos de datos estándar, COPY admite los siguientes formatos de datos en columnas para COPY de Amazon S3. Existen ciertas restricciones para poder usar el comando COPY con el formato de columnas. Para obtener más información, consulte [Uso de COPY con formatos de datos de columnas](copy-usage_notes-copy-from-columnar.md).
ORC
Carga los datos desde un archivo que utiliza el formato Optimized Row Columnar (ORC).
PARQUET
Carga los datos desde un archivo que utiliza el formato Parquet.
# Parámetros de compresión de archivos
Especifique los siguientes parámetros para cargar desde archivos de datos comprimidos. Parámetros de compresión de archivos
BZIP2
Un valor que especifica que el o los archivos de entrada están en el formato comprimido bzip2 (archivos .bz2). La operación COPY lee cada archivo comprimido y descomprime los datos a medida que los carga.
GZIP
Un valor que especifica que el o los archivos de entrada están en el formato comprimido gzip (archivos .gz). La operación COPY lee cada archivo comprimido y descomprime los datos a medida que los carga.
LZOP
Un valor que especifica que el o los archivos de entrada están en el formato comprimido lzop (archivos .lzo). La operación COPY lee cada archivo comprimido y descomprime los datos a medida que los carga.
COPY no admite archivos que estén comprimidos con la opción *--filter* de lzop.
ZSTD
Un valor que especifica que el o los archivos de entrada están en el formato comprimido Zstandard (archivos .zst). La operación COPY lee cada archivo comprimido y descomprime los datos a medida que los carga.
ZSTD solo es compatible con COPY de Amazon S3.
# Parámetros de conversión de datos
A medida que carga la tabla, COPY intenta convertir de forma implícita las cadenas de los datos de origen al tipo de datos de la columna de destino. Si necesita especificar una conversión que sea diferente a la del comportamiento predeterminado, o si la conversión predeterminada da lugar a errores, puede administrar las conversiones de datos especificando los siguientes parámetros. Para obtener más información sobre la sintaxis de estos parámetros, consulte [Sintaxis de COPY](https://docs.aws.amazon.com/redshift/latest/dg/r_COPY.html#r_COPY-syntax).
+ [ACCEPTANYDATE](#copy-acceptanydate)
+ [ACCEPTINVCHARS](#copy-acceptinvchars)
+ [BLANKSASNULL](#copy-blanksasnull)
+ [DATEFORMAT](#copy-dateformat)
+ [EMPTYASNULL](#copy-emptyasnull)
+ [ENCODING](#copy-encoding)
+ [ESCAPE](#copy-escape)
+ [EXPLICIT_IDS](#copy-explicit-ids)
+ [FILLRECORD](#copy-fillrecord)
+ [IGNOREBLANKLINES](#copy-ignoreblanklines)
+ [IGNOREHEADER](#copy-ignoreheader)
+ [NULL AS](#copy-null-as)
+ [REMOVEQUOTES](#copy-removequotes)
+ [ROUNDEC](#copy-roundec)
+ [TIMEFORMAT](#copy-timeformat)
+ [TRIMBLANKS](#copy-trimblanks)
+ [TRUNCATECOLUMNS](#copy-truncatecolumns) Parámetros de conversión de datos
ACCEPTANYDATE
Permite que se cargue cualquier formato de fecha, incluidos los formatos no válidos como `00/00/00 00:00:00`, sin generar un error. Este parámetro aplica solo para las columnas TIMESTAMP y DATE. Siempre utilice ACCEPTANYDATE con el parámetro DATEFORMAT. Si el formato de fecha de los datos no coincide con la especificación DATEFORMAT, Amazon Redshift inserta un valor NULL en ese campo.
ACCEPTINVCHARS [AS] ['*replacement\$1char*']
Permite cargar datos en las columnas VARCHAR, aunque los datos contengan caracteres UTF-8 no válidos. Cuando se especifica ACCEPTINVCHARS, COPY sustituye todos los caracteres UTF-8 no válidos por una cadena de la misma longitud que se compone del carácter especificado en *replacement\$1char (carácter\$1de\$1sustitución)*. Por ejemplo, si el carácter de sustitución es "`^`", un carácter de tres bytes no válido será sustituido por "`^^^`".
El carácter de sustitución puede ser cualquier carácter ASCII, excepto NULL. El carácter predeterminado es un signo de interrogación (?). Para obtener más información acerca de los caracteres UTF-8 no válidos, consulte [Errores de carga de caracteres multibyte](multi-byte-character-load-errors.md).
COPY devuelve el número de filas que contienen caracteres UTF-8 no válidos y agrega una entrada a la tabla de sistema [STL\$1REPLACEMENTS](r_STL_REPLACEMENTS.md) por cada fila afectada, hasta un máximo de 100 filas por cada sector del nodo. También se sustituyen otros caracteres UTF-8 no válidos, pero esos eventos de sustitución no se registran.
Si no se especifica ACCEPTINVCHARS, COPY devuelve un error siempre que encuentra un carácter UTF-8 no válido.
ACCEPTINVCHARS es válido solo para las columnas VARCHAR.
BLANKSASNULL
Carga los campos en blanco, que estén compuestos solo por caracteres de espacios en blanco, como NULL. Esta opción aplica solo para las columnas CHAR y VARCHAR. Los campos en blanco para otros tipos de datos, como INT, siempre se cargan con NULL. Por ejemplo, una cadena que contiene tres caracteres de espacio de forma sucesiva (y ningún otro carácter) se carga como NULL. El comportamiento predeterminado, sin esta opción, es cargar los caracteres de espacio como están.
DATEFORMAT [AS] \$1'*dateformat\$1string*' \$1 'auto' \$1
Si no se especifica DATEFORMAT, el formato predeterminado es `'YYYY-MM-DD'`. Por ejemplo, una alternativa de formato válida sería `'MM-DD-YYYY'`.
Si el comando COPY no reconoce el formato de los valores de fecha u hora, o si los valores de fecha u hora usan formatos diferentes, utilice el argumento `'auto'` con el parámetro DATEFORMAT o TIMEFORMAT. El argumento `'auto'` reconoce varios formatos que no se admiten cuando se utiliza una cadena DATEFORMAT y TIMEFORMAT. La palabra clave `'auto'` distingue entre mayúsculas y minúsculas. Para obtener más información, consulte [Utilización del reconocimiento automático con DATEFORMAT y TIMEFORMAT](automatic-recognition.md).
El formato de fecha puede incluir información de hora (hora, minutos, segundos), pero esta información se ignora. La palabra clave AS es opcional. Para obtener más información, consulte [Cadenas TIMEFORMAT y DATEFORMATEjemplo](r_DATEFORMAT_and_TIMEFORMAT_strings.md).
EMPTYASNULL
Indica que Amazon Redshift debe cargar los campos CHAR y VARCHAR vacíos como NULL. Los campos vacíos para otros tipos de datos, como INT, siempre se cargan con NULL. Los campos vacíos se producen cuando los datos contienen dos delimitadores de forma sucesiva sin caracteres entre los delimitadores. EMPTYASNULL y NULL AS '' (cadena vacía) producen el mismo comportamiento.
ENCODING [AS] *file\$1encoding*
Especifica el tipo de codificación de los datos de carga. El comando COPY convierte los datos de la codificación especificada a UTF-8 durante la carga.
Los valores válidos de *file\$1encoding* son los siguientes:
+ `UTF8`
+ `UTF16`
+ `UTF16LE`
+ `UTF16BE`
+ `ISO88591`
El valor predeterminado es `UTF8`.
Los nombres de archivo de origen deben utilizar la codificación UTF-8.
Los siguientes archivos deben utilizar la codificación UTF-8, aunque se especifique una codificación diferente para los datos de carga:
+ Archivos de manifiesto
+ Archivos JSONPaths
La cadena de argumentos proporcionada con los siguientes parámetros debe utilizar UTF-8:
+ FIXEDWIDTH '*fixedwidth\$1spec*'
+ ACCEPTINVCHARS '*replacement\$1char*'
+ DATEFORMAT '*dateformat\$1string*'
+ TIMEFORMAT '*timeformat\$1string*'
+ NULL AS '*null\$1string*'
Los archivos de datos de ancho fijo deben utilizar la codificación UTF-8. Los anchos de campo se basan en la cantidad de caracteres, no en el número de bytes.
Todos los datos de carga deben utilizar la codificación especificada. Si COPY encuentra una codificación diferente, omite el archivo y devuelve un error.
Si especifica `UTF16`, los datos deben tener una marca de orden de bytes (BOM). Si sabe si los datos UTF-16 tienen el formato little-endian (LE) o big-endian (BE), puede utilizar `UTF16LE` o `UTF16BE`, independientemente de la presencia de una BOM.
Para utilizar la codificación ISO-8859-1, especifique `ISO88591`. Para obtener más información, consulte [ISO/IEC 8859-1](https://en.wikipedia.org/wiki/ISO/IEC_8859-1) en *Wikipedia*.
ESCAPE
Cuando se especifica este parámetro, el carácter de barra oblicua inversa (`\`) en los datos de entrada se trata como un carácter de escape. El carácter que sigue inmediatamente al carácter de barra oblicua inversa se carga en la tabla como parte del valor actual de la columna, aunque sea un carácter que por lo general tiene un propósito especial. Por ejemplo, puede utilizar este parámetro para aplicar escape al carácter delimitador, a una comilla, a un carácter de línea nueva incrustado o al carácter de escape en sí cuando cualquiera de estos caracteres es una parte legítima del valor de una columna.
Si especifica el parámetro ESCAPE en combinación con el parámetro REMOVEQUOTES, puede aplicar escape y conservar las comillas (`'` o `"`) que, de otro modo, se podrían eliminar. La cadena nula predeterminada, `\N`, funciona como está, pero también se le puede aplicar escape en los datos de entrada como `\\N`. Mientras no especifique una cadena nula alternativa con el parámetro NULL AS, `\N` y `\\N` producirán los mismos resultados.
Al carácter de control `0x00` (NUL) no se le puede aplicar escape y se debe eliminar de los datos de entrada o se debe convertir. Este carácter se trata como un marcador de fin de registro (EOR), lo que provoca que el resto del registro se trunque.
No se puede utilizar el parámetro ESCAPE para las cargas FIXEDWIDTH y no se puede especificar el carácter de escape en sí. El carácter de escape es siempre la barra inversa. También, debe asegurarse de que los datos de entrada contengan el carácter de escape en los lugares adecuados.
Estos son algunos ejemplos de los datos de entrada y los datos cargados que se obtienen cuando se especifica el parámetro ESCAPE. El resultado de la fila 4 supone que también se especifica el parámetro REMOVEQUOTES. Los datos de entrada se componen por dos campos delimitados por barras verticales:
```
1|The quick brown fox\[newline]
jumped over the lazy dog.
2| A\\B\\C
3| A \| B \| C
4| 'A Midsummer Night\'s Dream'
```
Los datos cargados en la columna 2 tendrán este aspecto:
```
The quick brown fox
jumped over the lazy dog.
A\B\C
A|B|C
A Midsummer Night's Dream
```
La aplicación del carácter de escape a los datos de entrada para una carga es responsabilidad del usuario. Existe una excepción a este requisito cuando vuelve a cargar datos que se descargaron anteriormente con el parámetro ESCAPE. En este caso, los datos ya contendrán los caracteres de escape necesarios.
El parámetro ESCAPE no interpreta los códigos octal, hexadecimal, Unicode ni otras notaciones de secuencias de escape. Por ejemplo, si los datos de origen contienen el valor de salto de línea octal (`\012`) e intenta cargar estos datos con el parámetro ESCAPE, Amazon Redshift cargará el valor `012` en la tabla y no interpretará este valor como un salto de línea al que se le está aplicando escape.
Para poder aplicar escape a los caracteres de línea nueva en datos que se originan en plataformas de Microsoft Windows, es posible que necesite utilizar dos caracteres de escape: uno para el retorno de carro y otro para el salto de línea. También puede eliminar los retornos de carro antes de cargar el archivo (por ejemplo, mediante la utilidad dos2unix).
EXPLICIT\$1IDS
Utilice EXPLICIT\$1IDS con tablas que tengan columnas IDENTITY si desea sustituir los valores autogenerados con valores explícitos de los archivos de datos de origen para las tablas. Si el comando incluye una lista de columnas, esa lista debe incluir las columnas IDENTITY para utilizar este parámetro. El formato de datos para los valores EXPLICIT\$1IDS debe coincidir con el formato de IDENTITY especificado por la definición CREATE TABLE.
Cuando ejecute un comando COPY en una tabla con la opción EXPLICIT\$1IDS, Amazon Redshift no comprueba la singularidad de las columnas IDENTITY de la tabla.
Si una columna se define con GENERATED BY DEFAULT AS IDENTITY, se puede copiar. Los valores se generan o se actualizan con los que se proporcionan. La opción EXPLICIT\$1IDS no es obligatoria. COPY no actualiza el límite máximo de la identidad.
Para ver un ejemplo de un comando COPY que utiliza EXPLICIT\$1IDS, consulte [Carga de VENUE con valores explícitos para una columna IDENTITY](r_COPY_command_examples.md#r_COPY_command_examples-load-venue-with-explicit-values-for-an-identity-column).
FILLRECORD
Permite que se carguen los archivos de datos cuando faltan columnas contiguas al final de alguno de los registros. Las columnas que faltan se cargan como NULL. Para los formatos de texto y CSV, si la columna que falta es una columna VARCHAR, se cargan cadenas de longitud cero en lugar de NULL. Para cargar columnas NULL en columnas VARCHAR mediante texto y CSV, especifique la palabra clave EMPTYASNULL. La sustitución por NULL solo funciona si la definición de la columna permite NULL.
Por ejemplo, si la definición de la tabla contiene cuatro columnas CHAR con valores nulos y un registro contiene los valores `apple, orange, banana, mango`, el comando COPY podría cargar y completar un registro que solo contenga los valores `apple, orange`. Los valores CHAR faltantes se cargarían como valores NULL.
IGNOREBLANKLINES
Ignora las líneas en blanco que solo contienen un salto de línea en un archivo de datos y no prueba cargarlos.
IGNOREHEADER [ AS ] *number\$1rows*
Trata los valores *number\$1rows* (número\$1de\$1filas) especificados como un encabezado de archivo y no los carga. Utilice IGNOREHEADER para omitir encabezados de archivos de todos los archivos en una carga paralela.
NULL AS '*null\$1string*'
Carga los campos en los que el valor de *null\$1string* es NULL, donde *null\$1string* puede ser cualquier cadena. Si los datos incluyen un carácter nulo, también denominado NUL (UTF-8 0000) o cero binario (0x000), COPY lo trata como cualquier otro carácter. Por ejemplo, un registro que contiene '1' \$1\$1 NUL \$1\$1 '2' se copia como cadena de 3 bytes de longitud. Si un campo solo contiene NUL, puede utilizar NULL AS para reemplazar el carácter nulo con NULL mediante la especificación de `'\0'` o `'\000'`; por ejemplo, `NULL AS '\0'` o `NULL AS '\000'`. Si un campo contiene una cadena que termina con NUL y se especifica NULL AS, la cadena se inserta con NUL al final. No utilice '\$1n' (línea nueva) para el valor de *null\$1string*. Amazon Redshift reserva '\$1n' para utilizarlo como delimitador de línea. El valor de *null\$1string* predeterminado es `'\N`'.
Si intenta cargar valores nulos en una columna definida como NOT NULL, el comando COPY producirá un error.
REMOVEQUOTES
Elimina las comillas circundantes de las cadenas en los datos entrantes. Todos los caracteres dentro de las comillas, incluidos los delimitadores, se conservan. Si una cadena tiene una comilla de apertura simple o doble pero no su signo de cierre correspondiente, el comando COPY no puede cargar esa fila y devuelve un error. En la siguiente tabla, se muestran algunos ejemplos simples de cadenas que contienen comillas y los valores cargados que se obtienen.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/copy-parameters-data-conversion.html)
ROUNDEC
Redondea hacia arriba los valores numéricos cuando la escala del valor de entrada es mayor que la escala de la columna. De manera predeterminada, COPY trunca los valores cuando sea necesario ajustar la escala de la columna. Por ejemplo, si un valor de `20.259` se carga en una columna DECIMAL(8,2), COPY trunca el valor a `20.25` de manera predeterminada. Si se especifica ROUNDEC, COPY redondea el valor a `20.26`. El comando INSERT siempre redondea los valores cuando es necesario que coincidan con la escala de la columna, por lo que un comando COPY con el parámetro ROUNDEC se comporta igual que un comando INSERT.
TIMEFORMAT [AS] \$1'*timeformat\$1string*' \$1 'auto' \$1 'epochsecs' \$1 'epochmillisecs' \$1
Especifica el formato de hora. Si no se especifica TIMEFORMAT, el formato predeterminado es `YYYY-MM-DD HH:MI:SS` para las columnas TIMESTAMP o `YYYY-MM-DD HH:MI:SSOF` para las columnas TIMESTAMPTZ, donde `OF` es el desplazamiento de la hora universal coordinada (UTC). No puede incluir un especificador de zona horaria en *timeformat\$1string*. Para cargar datos TIMESTAMPTZ que estén en un formato diferente al predeterminado, especifique 'auto'. Para obtener más información, consulte [Utilización del reconocimiento automático con DATEFORMAT y TIMEFORMAT](automatic-recognition.md). Para obtener más información acerca de *timeformat\$1string*, consulte [Cadenas TIMEFORMAT y DATEFORMATEjemplo](r_DATEFORMAT_and_TIMEFORMAT_strings.md).
El argumento `'auto'` reconoce varios formatos que no se admiten cuando se utiliza una cadena DATEFORMAT y TIMEFORMAT. Si el comando COPY no reconoce el formato de los valores de fecha u hora, o si los valores de fecha y hora usan formatos diferentes entre sí, utilice el argumento `'auto'` con el parámetro DATEFORMAT o TIMEFORMAT. Para obtener más información, consulte [Utilización del reconocimiento automático con DATEFORMAT y TIMEFORMAT](automatic-recognition.md).
Si los datos de origen se representan como un tiempo de fecha de inicio, que es el número de segundos o milisegundos desde las 00:00:00 UTC del 1 de enero de 1970, especifique `'epochsecs'` o `'epochmillisecs'`.
Las palabras clave `'auto'`, `'epochsecs'` y `'epochmillisecs'` distinguen entre mayúsculas y minúsculas.
La palabra clave AS es opcional.
TRIMBLANKS
Elimina los caracteres de espacio en blanco del final de una cadena VARCHAR. Este parámetro aplica solo para las columnas con un tipo de datos VARCHAR.
TRUNCATECOLUMNS
Trunca los datos de las columnas al número adecuado de caracteres de modo que se ajuste a la especificación de la columna. Aplica solo para las columnas con un tipo de datos CHAR o VARCHAR y filas de 4 MB de tamaño, o menos.
# Operaciones de carga de datos
Administre el comportamiento predeterminado de la operación de carga para solucionar problemas o reducir los tiempos de carga especificando los siguientes parámetros.
+ [COMPROWS](#copy-comprows)
+ [COMPUPDATE](#copy-compupdate)
+ [IGNOREALLERRORS](#copy-ignoreallerrors)
+ [MAXERROR](#copy-maxerror)
+ [NOLOAD](#copy-noload)
+ [STATUPDATE](#copy-statupdate) Parameters
COMPROWS *numrows*
Especifica la cantidad de filas que se usarán como el tamaño de muestra para el análisis de compresión. El análisis se ejecuta sobre las filas de cada sector de datos. Por ejemplo, si especifica `COMPROWS 1000000` (1 000 000) y el sistema contiene cuatro sectores totales, se leen y analizan no más de 250 000 filas por cada sector.
Si no se especifica COMPROWS, el tamaño de muestra se establece de manera predeterminada en 100 000 en cada sector. Los valores de COMPROWS inferiores al valor predeterminado de 100 000 filas por cada sector se actualizan automáticamente al valor predeterminado. No obstante, la compresión automática no tendrá lugar si la cantidad de datos que se carga es insuficiente para producir una muestra significativa.
Si el número de COMPROWS es superior a la cantidad de filas del archivo de entrada, el comando COPY avanza y ejecuta el análisis de compresión en todas las filas disponibles. El rango aceptado para este argumento es un número entre 1000 y 2147483647 (2 147 483 647).
COMPUPDATE [PRESET \$1 \$1 ON \$1 TRUE \$1 \$1 \$1 OFF \$1 FALSE \$1 ]
Controla que las codificaciones de compresión se apliquen automáticamente durante un comando COPY.
Cuando COMPUPDATE está preestablecido, el comando COPY selecciona la codificación de compresión para cada columna si la tabla de destino está vacía, incluso si las columnas ya tienen codificaciones distintas de RAW. Actualmente, es posible reemplazar las codificaciones de las columnas especificadas. La codificación de cada columna se basa en el tipo de dato de la columna. No se realiza un muestreo de los datos. Amazon Redshift asigna de forma automática la codificación de compresión de la siguiente manera:
+ A las columnas que están definidas como claves de ordenación se les asigna una compresión RAW.
+ A las columnas que están definidas como tipos de datos BOOLEAN, REAL o DOUBLE PRECISION se les asigna una compresión RAW.
+ Las columnas que se definen como SMALLINT, INTEGER, BIGINT, DECIMAL, DATE, TIMESTAMP o TIMESTAMPTZ tienen asignada la compresión AZ64.
+ Las columnas que se definen como CHAR o VARCHAR tienen asignada la compresión LZO.
Cuando se omite COMPUPDATE, el comando COPY elige la codificación de compresión de cada columna solo si la tabla de destino está vacía y no se ha especificado una codificación (distinta de RAW) para ninguna de las columnas. Amazon Redshift determina la codificación de cada columna. No se realiza un muestreo de los datos.
Cuando COMPUPDATE está establecido en ON (o TRUE), o cuando se especifica COMPUDATE sin una opción, el comando COPY aplica la compresión automática si la tabla está vacía, aunque las columnas de la tabla ya tengan codificaciones diferentes a RAW. Actualmente, es posible reemplazar las codificaciones de las columnas especificadas. La codificación de cada columna se basa en un análisis de los datos de muestra. Para obtener más información, consulte [Carga de tablas con compresión automática](c_Loading_tables_auto_compress.md).
Cuando COMPUPDATE está establecido en OFF (o FALSE), se deshabilita la compresión automática. Las codificaciones de las columnas no cambian.
Para obtener información sobre la tabla del sistema para analizar la compresión, consulte [STL\$1ANALYZE\$1COMPRESSION](r_STL_ANALYZE_COMPRESSION.md).
IGNOREALLERRORS
Puede especificar esta opción para ignorar todos los errores que se produzcan durante la operación de carga.
No se puede especificar la opción IGNOREALLERRORS si ya se ha especificado la opción MAXERROR. No se puede especificar la opción IGNOREALLERRORS para formatos de columnas, tales como ORC y Parquet.
MAXERROR [AS] *error\$1count*
Si la carga devuelve la cantidad de errores especificada en *error\$1count* (número\$1de\$1errores) o una cantidad mayor, la carga no se realiza correctamente. Si la carga devuelve menos errores, continúa y devuelve un mensaje INFO que establece el número de filas que no se pudieron cargar. Utilice este parámetro para permitir que las cargas continúen cuando determinadas filas no puedan cargarse en la tabla a causa de errores de formato u otras inconsistencias de los datos.
Establezca este valor en `0` o `1` si desea que la carga falle en el momento que suceda el primer error. La palabra clave AS es opcional. El valor predeterminado de MAXERROR es `0` y el límite `100000`.
El número real de errores notificados puede ser mayor que el MAXERROR especificado debido a la naturaleza paralela de Amazon Redshift. Si algún nodo del clúster de Amazon Redshift detecta que MAXERROR se ha superado, cada nodo notifica todos los errores que ha encontrado.
NOLOAD
Verifica la validez de los archivos de datos sin cargar los datos realmente. Utilice el parámetro NOLOAD para asegurar que los archivos de datos se cargan sin errores antes de ejecutar la carga de datos real. La ejecución de COPY con el parámetro NOLOAD es mucho más rápida que la carga de datos ya que solo analiza los archivos.
STATUPDATE [ \$1 ON \$1 TRUE \$1 \$1 \$1 OFF \$1 FALSE \$1 ]
Controla la actualización y los cálculos automáticos de las estadísticas del optimizador al final de un COPY correcto. De manera predeterminada, cuando el parámetro STATUPDATE no se utiliza, las estadísticas se actualizan de forma automática si inicialmente la tabla está vacía.
Siempre que una inserción de datos en una tabla que no esté vacía cambie el tamaño de la tabla significativamente, le recomendamos actualizar las estadísticas con la ejecución de un comando [ANALYZE](r_ANALYZE.md) o mediante el argumento STATUPDATE ON.
Con STATUPDATE ON (o TRUE), las estadísticas se actualizan de forma automática independientemente de si la tabla está vacía inicialmente. Si se utiliza STATUPDATE, el usuario actual debe ser el propietario de la tabla o un super usuario. Si no se especifica STATUPDATE, solo se requiere el permiso INSERT.
Con STATUPDATE OFF (o FALSE), las estadísticas nunca se actualizan.
Para obtener información adicional, consulta [Análisis de tablas](t_Analyzing_tables.md).
# Lista alfabética de parámetros
La siguiente lista proporciona los enlaces a cada descripción de parámetros del comando COPY, ordenadas alfabéticamente.
+ [ACCEPTANYDATE](copy-parameters-data-conversion.md#copy-acceptanydate)
+ [ACCEPTINVCHARS](copy-parameters-data-conversion.md#copy-acceptinvchars)
+ [ACCESS\$1KEY\$1ID, SECRET\$1ACCESS\$1KEY](copy-parameters-authorization.md#copy-access-key-id-access)
+ [AVRO](copy-parameters-data-format.md#copy-avro)
+ [BLANKSASNULL](copy-parameters-data-conversion.md#copy-blanksasnull)
+ [BZIP2](copy-parameters-file-compression.md#copy-bzip2)
+ [COMPROWS](copy-parameters-data-load.md#copy-comprows)
+ [COMPUPDATE](copy-parameters-data-load.md#copy-compupdate)
+ [CREDENTIALS](copy-parameters-authorization.md#copy-credentials-cred)
+ [CSV](copy-parameters-data-format.md#copy-csv)
+ [DATEFORMAT](copy-parameters-data-conversion.md#copy-dateformat)
+ [DELIMITER](copy-parameters-data-format.md#copy-delimiter)
+ [EMPTYASNULL](copy-parameters-data-conversion.md#copy-emptyasnull)
+ [ENCODING](copy-parameters-data-conversion.md#copy-encoding)
+ [ENCRYPTED](copy-parameters-data-source-s3.md#copy-encrypted)
+ [ESCAPE](copy-parameters-data-conversion.md#copy-escape)
+ [EXPLICIT_IDS](copy-parameters-data-conversion.md#copy-explicit-ids)
+ [FILLRECORD](copy-parameters-data-conversion.md#copy-fillrecord)
+ [FIXEDWIDTH](copy-parameters-data-format.md#copy-fixedwidth)
+ [FORMAT](copy-parameters-data-format.md#copy-format)
+ [FROM](copy-parameters-data-source-s3.md#copy-parameters-from)
+ [GZIP](copy-parameters-file-compression.md#copy-gzip)
+ [IAM\$1ROLE](copy-parameters-authorization.md#copy-iam-role-iam)
+ [IGNOREALLERRORS](copy-parameters-data-load.md#copy-ignoreallerrors)
+ [IGNOREBLANKLINES](copy-parameters-data-conversion.md#copy-ignoreblanklines)
+ [IGNOREHEADER](copy-parameters-data-conversion.md#copy-ignoreheader)
+ [JSON format for COPY](copy-parameters-data-format.md#copy-json)
+ [LZOP](copy-parameters-file-compression.md#copy-lzop)
+ [MANIFEST](copy-parameters-data-source-s3.md#copy-manifest)
+ [MASTER_SYMMETRIC_KEY](copy-parameters-data-source-s3.md#copy-master-symmetric-key)
+ [MAXERROR](copy-parameters-data-load.md#copy-maxerror)
+ [NOLOAD](copy-parameters-data-load.md#copy-noload)
+ [NULL AS](copy-parameters-data-conversion.md#copy-null-as)
+ [READRATIO](copy-parameters-data-source-dynamodb.md#copy-readratio)
+ [REGION](copy-parameters-data-source-s3.md#copy-region)
+ [REMOVEQUOTES](copy-parameters-data-conversion.md#copy-removequotes)
+ [ROUNDEC](copy-parameters-data-conversion.md#copy-roundec)
+ [SESSION\$1TOKEN](copy-parameters-authorization.md#copy-token)
+ [SHAPEFILE](copy-parameters-data-format.md#copy-shapefile)
+ [SSH](copy-parameters-data-source-ssh.md#copy-ssh)
+ [STATUPDATE](copy-parameters-data-load.md#copy-statupdate)
+ [TIMEFORMAT](copy-parameters-data-conversion.md#copy-timeformat)
+ [TRIMBLANKS](copy-parameters-data-conversion.md#copy-trimblanks)
+ [TRUNCATECOLUMNS](copy-parameters-data-conversion.md#copy-truncatecolumns)
+ [ZSTD](copy-parameters-file-compression.md#copy-zstd)
# Notas de uso
**Topics**
+ [Permisos para acceder a otros recursos de AWS](copy-usage_notes-access-permissions.md)
+ [Uso de COPY con alias de puntos de acceso de Amazon S3](copy-usage_notes-s3-access-point-alias.md)
+ [Carga de datos multibyte desde Amazon S3](copy-usage_notes-multi-byte.md)
+ [Carga de una columna de tipo de datos GEOMETRY o GEOGRAPHY](copy-usage_notes-spatial-data.md)
+ [Carga del tipo de datos HLLSKETCH](copy-usage_notes-hll.md)
+ [Carga de una columna de tipo de datos VARBYTE](copy-usage-varbyte.md)
+ [Errores al leer varios archivos](copy-usage_notes-multiple-files.md)
+ [COPY de formato JSON](copy-usage_notes-copy-from-json.md)
+ [Uso de COPY con formatos de datos de columnas](copy-usage_notes-copy-from-columnar.md)
+ [Cadenas TIMEFORMAT y DATEFORMAT](r_DATEFORMAT_and_TIMEFORMAT_strings.md)
+ [Utilización del reconocimiento automático con DATEFORMAT y TIMEFORMAT](automatic-recognition.md)
# Permisos para acceder a otros recursos de AWS
Para trasladar datos entre el clúster y otro recurso de AWS, como Amazon S3, Amazon DynamoDB, Amazon EMR o Amazon EC2, el clúster debe tener permiso para acceder al recurso y realizar las acciones necesarias. Por ejemplo, para cargar datos de Amazon S3, COPY debe tener acceso LIST para el bucket y acceso GET para los objetos del bucket. Para obtener información acerca de los permisos mínimos, consulte [Permisos de IAM para COPY, UNLOAD y CREATE LIBRARY](#copy-usage_notes-iam-permissions).
Para obtener la autorización para acceder al recurso, el clúster debe estar autenticado. Puede seleccionar uno de los siguientes métodos de autenticación:
+ [Control de acceso con base en roles](#copy-usage_notes-access-role-based): en el caso del control de acceso basado en roles, se especifica un rol de AWS Identity and Access Management (IAM) que el clúster utiliza para la autenticación y la autorización. Para salvaguardar las credenciales de AWS y la información confidencial, le recomendamos encarecidamente utilizar una autenticación basada en roles.
+ [Control de acceso basado en claves](#copy-usage_notes-access-key-based): en el caso del control de acceso basado en claves, se proporcionan las credenciales de acceso de AWS (ID de clave de acceso y clave de acceso secreta) de un usuario como texto sin formato.
## Control de acceso con base en roles
Con el control de acceso basado en roles, el clúster adopta de forma temporal un rol de IAM en su nombre. Luego, en función de las autorizaciones que se otorgaron al rol, su clúster puede acceder a los recursos de AWS requeridos.
La creación de un *rol* de IAM es similar a la concesión de permisos a un usuario, en el sentido de que se trata de una identidad de AWS con políticas de permisos que determinan lo que la identidad puede y no puede hacer en AWS. No obstante, en lugar de asociarse exclusivamente a un usuario, cualquier entidad puede asumir un rol cuando lo necesite. Además, un rol no tiene ninguna credencial (una contraseña o claves de acceso) asociada a él. En cambio, si se asocia un rol a un clúster, se crean de forma dinámica claves de acceso y se proporcionan al clúster.
Recomendamos el uso de control de acceso basado en roles porque ofrece un control más preciso y seguro del acceso a los recursos de AWS y a la información confidencial de los usuarios, además de salvaguardar las credenciales de AWS.
La autenticación basada en roles brinda los siguientes beneficios:
+ Puede utilizar las herramientas de IAM estándar de AWS para definir un rol de IAM y asociarlo a varios clústeres. Cuando se modifica una política de acceso de un rol, los cambios se aplican automáticamente a todos los clústeres que utilicen ese rol.
+ Puede definir políticas de IAM pormenorizadas que concedan permisos para que clústeres y usuarios de bases de datos específicos puedan acceder a determinadas acciones y recursos de AWS.
+ El clúster obtiene credenciales de sesión temporales en tiempo de ejecución y actualiza las credenciales según se necesite hasta que se complete la operación. En el caso de que utilice credenciales temporales basadas en claves, si estas vencen antes de completarse la operación, la operación falla.
+ El ID de clave de acceso y el ID de clave de acceso secreta no se almacenan ni se transmiten en el código SQL.
Para utilizar el control de acceso basado en roles, primero debe crear un rol de IAM mediante el tipo de función del servicio de Amazon Redshift y, luego, debe adjuntarlo al clúster. Como mínimo, el rol debe tener los permisos especificados en [Permisos de IAM para COPY, UNLOAD y CREATE LIBRARY](#copy-usage_notes-iam-permissions). Para conocer los pasos que se deben realizar para crear un rol de IAM y adjuntarlo a un clúster, consulte [Autorización a Amazon Redshift para acceder a otros servicios de AWS en su nombre](https://docs.aws.amazon.com/redshift/latest/mgmt/authorizing-redshift-service.html) en la *Guía de administración de Amazon Redshift*.
Puede agregar un rol a un clúster o ver los roles asociados a un clúster mediante la consola de administración, la CLI o la API de Amazon Redshift. Para obtener más información, consulte [Asociación de un rol de IAM a un clúster](https://docs.aws.amazon.com/redshift/latest/mgmt/copy-unload-iam-role.html) en la *Guía de administración de Amazon Redshift*.
Al crear un rol de IAM, IAM devuelve el Amazon Resource Name (ARN, Nombre de recurso de Amazon) del rol. Para especificar un rol de IAM, proporcione el ARN del rol con el parámetro [Uso del parámetro IAM\$1ROLE](copy-parameters-authorization.md#copy-iam-role) o el parámetro [Uso del parámetro CREDENTIALS](copy-parameters-authorization.md#copy-credentials).
Por ejemplo, suponga que se asocia el siguiente rol al clúster.
```
"IamRoleArn": "arn:aws:iam::0123456789012:role/MyRedshiftRole"
```
En el siguiente ejemplo, el comando COPY utiliza el parámetro IAM\$1ROLE con el ARN del ejemplo anterior para la autenticación y el acceso a Amazon S3.
```
copy customer from 's3://amzn-s3-demo-bucket/mydata'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole';
```
En el siguiente ejemplo de comando COPY se utiliza el parámetro CREDENTIALS para especificar el rol de IAM.
```
copy customer from 's3://amzn-s3-demo-bucket/mydata'
credentials
'aws_iam_role=arn:aws:iam::0123456789012:role/MyRedshiftRole';
```
Además, un superusuario puede conceder el privilegio ASSUMEROLE a los usuarios y los grupos de bases de datos con objeto de proporcionar acceso a un rol para las operaciones COPY. Para obtener más información, consulte [GRANT](r_GRANT.md).
## Control de acceso basado en claves
Con el control de acceso basado en claves, se proporciona el ID de clave de acceso y la clave de acceso secreta de un usuario de IAM que está autorizado a acceder a los recursos de AWS que contienen los datos. Puede utilizar los parámetros [Uso de los parámetros ACCESS\$1KEY\$1ID y SECRET\$1ACCESS\$1KEY](copy-parameters-authorization.md#copy-access-key-id) juntos o el parámetro [Uso del parámetro CREDENTIALS](copy-parameters-authorization.md#copy-credentials).
**nota**
Recomendamos encarecidamente que use un rol de IAM para su autenticación, en lugar de brindar un ID de clave de acceso y una clave de acceso secreta como texto sin formato. Si elige el control de acceso basado en claves, nunca utilice las credenciales (raíz) de su cuenta de AWS. Siempre cree un usuario de IAM y proporcione el ID de clave de acceso y la clave de acceso secreta de ese usuario. Si desea conocer los pasos necesarios para crear un usuario de IAM, consulte [Creación de un usuario de IAM en su cuenta de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html).
Para realizar la autenticación con ACCESS\$1KEY\$1ID y SECRET\$1ACCESS\$1KEY, sustituya ** y ** por el ID de clave de acceso de un usuario autorizado y la clave de acceso secreta completa, tal y como se muestra a continuación.
```
ACCESS_KEY_ID ''
SECRET_ACCESS_KEY '';
```
Para realizar la autenticación con el parámetro CREDENTIALS, sustituya ** y ** por el ID de clave de acceso de un usuario autorizado y la clave de acceso secreta completa, tal y como se muestra a continuación.
```
CREDENTIALS
'aws_access_key_id=;aws_secret_access_key=';
```
Como mínimo, el usuario de IAM debe tener los permisos que se indican en [Permisos de IAM para COPY, UNLOAD y CREATE LIBRARY](#copy-usage_notes-iam-permissions).
### Credenciales de seguridad temporales
Si utiliza el control de acceso basado en claves, puede limitar más el acceso que los usuarios tienen a los datos mediante el uso de credenciales de seguridad temporales. La autenticación basada en roles utiliza de forma automática credenciales temporales.
**nota**
Le recomendamos encarecidamente utilizar [role-based access control](#copy-usage_notes-access-role-based.phrase) en lugar de crear credenciales temporales y proporcionar el ID de clave de acceso y la clave de acceso secreta como texto sin formato. El control de acceso basado en roles utiliza de forma automática credenciales temporales.
Las credenciales de seguridad temporales proporcionan más seguridad debido a su breve vigencia y al hecho de que no se pueden reutilizar cuando vencen. El ID de clave de acceso y la clave de acceso secreta generados con el token no pueden utilizarse sin el token, y un usuario que tenga estas credenciales de seguridad temporales puede acceder a los recursos solo hasta que estas venzan.
Para conceder a los usuarios acceso temporal a los recursos, debe llamar a las operaciones de API de AWS Security Token Service (AWS STS). Las operaciones de API de AWS STS devuelven credenciales de seguridad temporales compuestas por un token de seguridad, un ID de clave de acceso y una clave de acceso secreta. Emita las credenciales de seguridad temporales a los usuarios que necesiten obtener acceso temporalmente a los recursos. Estos usuarios pueden ser usuarios de IAM existentes o pueden ser usuarios que no utilizan AWS. Para obtener más información acerca de la creación de credenciales de seguridad temporales, consulte [Uso de credenciales de seguridad temporales](https://docs.aws.amazon.com/STS/latest/UsingSTS/Welcome.html) en la Guía del usuario de IAM.
Puede utilizar los parámetros [Uso de los parámetros ACCESS\$1KEY\$1ID y SECRET\$1ACCESS\$1KEY](copy-parameters-authorization.md#copy-access-key-id) junto con el parámetro [SESSION\$1TOKEN](copy-parameters-authorization.md#copy-token) o el parámetro [Uso del parámetro CREDENTIALS](copy-parameters-authorization.md#copy-credentials). También debe suministrar el ID de clave de acceso y la clave de acceso secreta que se proporcionaron con el token.
Para realizar la autenticación con ACCESS\$1KEY\$1ID, SECRET\$1ACCESS\$1KEY y SESSION\$1TOKEN, sustituya **, ** y **, tal y como se muestra a continuación.
```
ACCESS_KEY_ID ''
SECRET_ACCESS_KEY ''
SESSION_TOKEN '';
```
Para autenticar con CREDENTIALS, incluya `session_token=` en la cadena de credenciales, como se muestra a continuación.
```
CREDENTIALS
'aws_access_key_id=;aws_secret_access_key=;session_token=';
```
En el siguiente ejemplo, se muestra un comando COPY con credenciales de seguridad temporales.
```
copy table-name
from 's3://objectpath'
access_key_id ''
secret_access_key ''
session_token '';
```
En el siguiente ejemplo, se carga la tabla LISTING con credenciales temporales y cifrado de archivos.
```
copy listing
from 's3://amzn-s3-demo-bucket/data/listings_pipe.txt'
access_key_id ''
secret_access_key ''
session_token ''
master_symmetric_key ''
encrypted;
```
En el siguiente ejemplo, se carga la tabla LISTING mediante el parámetro CREDENTIALS con credenciales temporales y cifrado de archivos.
```
copy listing
from 's3://amzn-s3-demo-bucket/data/listings_pipe.txt'
credentials
'aws_access_key_id=;aws_secret_access_key=;session_token=;master_symmetric_key='
encrypted;
```
**importante**
Las credenciales de seguridad temporales deben ser válidas durante toda la operación COPY o UNLOAD. Si las credenciales de seguridad temporales vencen durante la operación, el comando falla y se revierte la transacción. Por ejemplo, si las credenciales de seguridad temporales vencen después de 15 minutos y la operación COPY requiere una hora, el comando COPY falla antes de completarse. Si utiliza un acceso basado en roles, las credenciales de seguridad temporales se actualizan de forma automática hasta que se complete la operación.
## Permisos de IAM para COPY, UNLOAD y CREATE LIBRARY
El rol o usuario de IAM indicado por el parámetro CREDENTIALS debe tener, como mínimo, los siguientes permisos:
+ Para utilizar COPY de Amazon S3, debe tener permiso para utilizar LIST sobre el bucket de Amazon S3 y GET sobre los objetos de Amazon S3 que se están cargando y el archivo de manifiesto, si se utiliza alguno.
+ Para utilizar COPY de Amazon S3, Amazon EMR y los alojamientos remotos (SSH) con datos en formato JSON deben tener permiso para utilizar LIST y GET con el archivo JSONPaths de Amazon S3, si se utiliza uno.
+ Para utilizar COPY de DynamoDB, debe tener permiso para utilizar SCAN y DESCRIBE en la tabla de DynamoDB que se está cargando.
+ Para utilizar COPY desde un clúster de Amazon EMR, debe tener permiso para la acción `ListInstances` en el clúster de Amazon EMR.
+ Para utilizar UNLOAD en Amazon S3, debe tener permisos para usar GET, LIST y PUT sobre el bucket de Amazon S3 en que se están descargando los archivos de datos.
+ Para utilizar CREATE LIBRARY de Amazon S3, debe tener permiso para usar LIST sobre el bucket de Amazon S3 y GET sobre los objetos de Amazon S3 que se están importando.
**nota**
Si recibe el mensaje de error `S3ServiceException: Access Denied` cuando ejecuta un comando COPY, UNLOAD o CREATE LIBRARY, el clúster no dispone de los permisos de acceso adecuados para Amazon S3.
Puede administrar los permisos de IAM si asocia una política de IAM a un rol de IAM que esté asociado a su clúster, a un usuario o al grupo al que pertenezca su usuario. Por ejemplo, la política administrada `AmazonS3ReadOnlyAccess` concede permisos para utilizar LIST y GET sobre los recursos de Amazon S3. Para obtener más información acerca de las políticas de IAM, consulte [Administración de las políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) en la *Guía del usuario de IAM*.
# Uso de COPY con alias de puntos de acceso de Amazon S3
COPY admite alias de puntos de acceso de Amazon S3. Para obtener más información, consulte [Uso de un alias de estilo bucket en su punto de acceso](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points-alias.html) en la *Guía del usuario de Amazon Simple Storage Service*.
# Carga de datos multibyte desde Amazon S3
Si los datos incluyen caracteres multibyte no ASCII (como caracteres cirílicos o chinos) debe cargar los datos en columnas VARCHAR. El tipo de datos VARCHAR admite caracteres UTF-8 de cuatro bytes, pero el tipo de datos CHAR solo acepta caracteres ASCII de un solo byte. No se pueden cargar caracteres de cinco bytes o más en las tablas de Amazon Redshift. Para obtener más información, consulte [Caracteres multibyte](c_Supported_data_types.md#c_Supported_data_types-multi-byte-characters).
# Carga de una columna de tipo de datos GEOMETRY o GEOGRAPHY
Solo se puede utilizar COPY en columnas `GEOMETRY` o `GEOGRAPHY` a partir de datos de un archivo de texto delimitado por caracteres, como un archivo CSV. Los datos deben tener la forma hexadecimal del formato well-known binary format (ya sea WKB o EWKB) o el formato well-known text format (ya sea WKT o EWKT) y deben caber dentro del tamaño máximo de una sola fila de entrada al comando COPY. Para obtener más información, consulte [COPY](r_COPY.md).
Para obtener información sobre cómo cargar desde un shapefile, consulte [Carga de un shapefile en Amazon Redshift](spatial-copy-shapefile.md).
Para obtener más información acerca del tipo de datos `GEOMETRY` o `GEOGRAPHY`, consulte [Consulta de datos espaciales en Amazon Redshift](geospatial-overview.md).
# Carga del tipo de datos HLLSKETCH
Los bocetos HLL solo se pueden copiar en formato disperso o denso compatible con Amazon Redshift. Para utilizar el comando COPY en bocetos de HyperLogLog, use el formato Base64 para bocetos de HyperLogLog densos y el formato JSON para bocetos de HyperLogLog dispersos. Para obtener más información, consulte [Funciones HyperLogLog](hyperloglog-functions.md).
En el siguiente ejemplo, se importan datos de un archivo CSV a una tabla mediante CREATE TABLE y COPY. Primero, el ejemplo crea la tabla `t1` con CREATE TABLE.
```
CREATE TABLE t1 (sketch hllsketch, a bigint);
```
Luego, utiliza COPY para importar datos de un archivo CSV a la tabla `t1`.
```
COPY t1 FROM s3://amzn-s3-demo-bucket/unload/' IAM_ROLE 'arn:aws:iam::0123456789012:role/MyRedshiftRole' NULL AS 'null' CSV;
```
# Carga de una columna de tipo de datos VARBYTE
Puede cargar datos desde un archivo en formato CSV, Parquet y ORC. Para CSV, los datos se cargan desde un archivo en representación hexadecimal de los datos VARBYTE. No se pueden cargar datos VARBYTE con la opción `FIXEDWIDTH`. No se admiten las opciones `ADDQUOTES` ni `REMOVEQUOTES` de COPY. Una columna VARBYTE no se puede utilizar como columna de partición.
# Errores al leer varios archivos
El comando COPY es atómico y de transacciones. En otras palabras, aunque el comando COPY lee datos de varios archivos, todo el proceso se trata como una sola transacción. Si COPY enfrenta un error cuando lee un archivo, vuelve a ejecutarse de forma automática hasta que se agota el tiempo de espera del proceso (consulte [statement\$1timeout](r_statement_timeout.md)) o si los datos no se pueden descargar de Amazon S3 durante un periodo prolongado (entre 15 y 30 minutos), lo que garantiza que cada archivo se cargue solo una vez. Si el comando COPY falla, se anula toda la transacción y se revierten todos los cambios. Para obtener más información acerca de la administración de errores de carga, consulte [Solución de problemas en cargas de datos](t_Troubleshooting_load_errors.md).
Cuando un comando COPY se ha iniciado de forma correcta, no deja de ejecutarse correctamente aunque termine la sesión; por ejemplo, si el cliente se desconecta. No obstante, si el comando COPY está en un bloque de transacción BEGIN ... END que no se completa porque termina la sesión, se revierte toda la transacción, incluida la instrucción COPY. Para obtener más información acerca de las transacciones, consulte [BEGIN](r_BEGIN.md).
# COPY de formato JSON
La estructura de datos JSON se compone de un conjunto de objetos o matrices. Un *objeto* JSON comienza y termina con llaves, y contiene una colección desordenada de pares de nombre-valor. Cada nombre y valor está separado por dos puntos y los pares están separados por comas. El nombre es una cadena entre comillas dobles. Los caracteres de comillas deben ser comillas simples (0x22), no las comillas inclinadas o “inteligentes”.
Una *matriz* JSON comienza y termina con corchetes y contiene una colección ordenada de valores separados por comas. Un valor puede ser una cadena entre comillas dobles, un número, un booleano true o false, nulo, un objeto JSON o una matriz.
Los objetos y las matrices JSON se pueden anidar, lo que habilita una estructura jerárquica de datos. En el siguiente ejemplo, se muestra una estructura de datos JSON con dos objetos válidos.
```
{
"id": 1006410,
"title": "Amazon Redshift Database Developer Guide"
}
{
"id": 100540,
"name": "Amazon Simple Storage Service User Guide"
}
```
En el siguiente se muestran los mismos datos como dos matrices JSON.
```
[
1006410,
"Amazon Redshift Database Developer Guide"
]
[
100540,
"Amazon Simple Storage Service User Guide"
]
```
## Opciones de COPY para JSON
Cuando utilice COPY con datos en formato JSON, puede especificar las siguientes opciones:
+ `'auto' `: COPY carga de forma automática los campos del archivo JSON.
+ `'auto ignorecase'`: COPY carga de forma automática los campos del archivo JSON mientras ignora las mayúsculas y las minúsculas de los nombres de los campos.
+ `s3://jsonpaths_file`: COPY utiliza un archivo JSONPaths para analizar los datos de origen JSON. Un *archivo JSONPaths* es un archivo de texto que contiene un solo objeto JSON con el nombre `"jsonpaths"` combinado con una matriz de expresiones JSONPath. Si el nombre es cualquier cadena diferente a `"jsonpaths"`, COPY utiliza el argumento `'auto'` en lugar de utilizar el archivo JSONPaths.
Por obtener ejemplos que muestren cómo cargar datos mediante `'auto'`, `'auto ignorecase'` o un archivo JSONPaths, y mediante matrices y objetos JSON, consulte [Ejemplos de Copy de JSON](r_COPY_command_examples.md#r_COPY_command_examples-copy-from-json).
## Opción JSONPath
En la sintaxis de COPY de Amazon Redshift, una expresión JSONPath especifica la ruta explícita a un elemento de nombre único en una estructura de datos jerárquica JSON, mediante notaciones con corchetes o con puntos. Amazon Redshift no admite ningún elemento de JSONPath, como caracteres comodín o expresiones de filtro, que pueda resolverse como una ruta ambigua o como varios elementos de nombre. Por este motivo, Amazon Redshift no puede analizar estructuras de datos complejas de varios niveles.
El siguiente es un ejemplo de un archivo JSONPaths con expresiones JSONPath que utilizan la notación con corchetes. El símbolo de dólar (\$1) representa la estructura de nivel raíz.
```
{
"jsonpaths": [
"$['id']",
"$['store']['book']['title']",
"$['location'][0]"
]
}
```
En el ejemplo anterior, `$['location'][0]` hace referencia al primer elemento de una matriz. JSON utiliza la indexación de matrices de base cero. Los índices de matriz deben ser números enteros positivos (igual o mayor que cero).
En el siguiente ejemplo, se muestra el archivo JSONPaths anterior que utiliza la notación con puntos.
```
{
"jsonpaths": [
"$.id",
"$.store.book.title",
"$.location[0]"
]
}
```
No puede combinar las notaciones con corchetes y con puntos en la matriz `jsonpaths`. Los corchetes se pueden utilizar en la notación con corchetes y en la notación con puntos para hacer referencia a un elemento de matriz.
Cuando se utiliza la notación con puntos, las expresiones JSONPath no pueden contener los siguientes caracteres:
+ Comilla simple recta ( ' )
+ Punto (.)
+ Corchetes ( [ ] ), a menos que se utilice para hacer referencia a una elemento de matriz
Si el valor del par de nombre-valor indicado por una expresión JSONPath es un objeto o una matriz, todo el objeto o la matriz se carga como una cadena, incluidos los corchetes o las llaves. Por ejemplo, suponga que los datos JSON contienen el siguiente objeto.
```
{
"id": 0,
"guid": "84512477-fa49-456b-b407-581d0d851c3c",
"isActive": true,
"tags": [
"nisi",
"culpa",
"ad",
"amet",
"voluptate",
"reprehenderit",
"veniam"
],
"friends": [
{
"id": 0,
"name": "Martha Rivera"
},
{
"id": 1,
"name": "Renaldo"
}
]
}
```
La expresión JSONPath `$['tags']` luego devuelve el siguiente valor.
```
"["nisi","culpa","ad","amet","voluptate","reprehenderit","veniam"]"
```
La expresión JSONPath `$['friends'][1]` luego devuelve el siguiente valor.
```
"{"id": 1,"name": "Renaldo"}"
```
Cada expresión JSONPath de la matriz `jsonpaths` corresponde a una columna de la tabla de destino de Amazon Redshift. El orden de los elementos de la matriz `jsonpaths` debe coincidir con el orden de las columnas en la tabla de destino o en la lista de columnas, si se utiliza una.
Por obtener ejemplos que muestren cómo cargar datos utilizando un argumento `'auto'` o un archivo JSONPaths y cómo utilizar los objetos y matrices JSON, consulte [Ejemplos de Copy de JSON](r_COPY_command_examples.md#r_COPY_command_examples-copy-from-json).
Para obtener información sobre cómo copiar varios archivos JSON, consulte [Uso de un manifiesto para especificar archivos de datos](loading-data-files-using-manifest.md).
## Caracteres de escape en JSON
COPY carga `\n` como un carácter de línea nueva y `\t` como un tabulador. Para cargar una barra inversa, aplique escape con una barra inversa ( `\\` ).
Suponga, por ejemplo, que tiene el siguiente JSON en un archivo denominado `escape.json` en el bucket `s3://amzn-s3-demo-bucket/json/`.
```
{
"backslash": "This is a backslash: \\",
"newline": "This sentence\n is on two lines.",
"tab": "This sentence \t contains a tab."
}
```
Ejecute los siguientes comandos para crear la tabla ESCAPES y cargar el JSON.
```
create table escapes (backslash varchar(25), newline varchar(35), tab varchar(35));
copy escapes from 's3://amzn-s3-demo-bucket/json/escape.json'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
format as json 'auto';
```
Consulte la tabla ESCAPES para ver los resultados.
```
select * from escapes;
backslash | newline | tab
------------------------+-------------------+----------------------------------
This is a backslash: \ | This sentence | This sentence contains a tab.
: is on two lines.
(1 row)
```
## Pérdida de precisión numérica
Puede perder precisión al cargar números de archivos de datos en formato JSON a una columna definida como tipo de datos numéricos. Algunos valores de coma flotante no se representan exactamente igual en distintos sistemas informáticos. Por ello, es posible que los datos que copie de un archivo JSON no se redondeen según lo esperado. Para evitar una pérdida de precisión, le recomendamos que utilice una de las siguientes alternativas:
+ Represente el número como una cadena encerrando el valor entre comillas dobles.
+ Use [ROUNDEC](copy-parameters-data-conversion.md#copy-roundec) para redondear el número en lugar de truncarlo.
+ En vez de utilizar archivos JSON o Avro, use archivos CSV, de ancho fijo o delimitados por caracteres.
# Uso de COPY con formatos de datos de columnas
El comando COPY puede cargar datos de Amazon S3 en los siguientes formatos en columnas:
+ ORC
+ Parquet
Para ver ejemplos del uso de COPY a partir de formatos de datos en columnas, consulte[Ejemplos de COPY](r_COPY_command_examples.md).
COPY admite los datos que tienen formato de columna con las siguientes consideraciones:
+ El bucket de Amazon S3 debe estar en la misma región de AWS que la base de datos de Amazon Redshift.
+ Para acceder a los datos de Amazon S3 a través de un punto de conexión de VPC, configure el acceso mediante políticas de IAM y roles de IAM como se describe en [Uso de Amazon Redshift Spectrum con el enrutamiento de VPC mejorado](https://docs.aws.amazon.com/redshift/latest/mgmt/spectrum-enhanced-vpc.html) en la *Guía de administración de Amazon Redshift*.
+ El comando COPY no aplica automáticamente codificaciones de compresión.
+ Solo se admiten los siguientes parámetros de COPY:
+ [ACCEPTINVCHARS](copy-parameters-data-conversion.md#copy-acceptinvchars) al copiar desde un archivo ORC o Parquet.
+ [FILLRECORD](copy-parameters-data-conversion.md#copy-fillrecord)
+ [FROM](copy-parameters-data-source-s3.md#copy-parameters-from)
+ [IAM\$1ROLE](copy-parameters-authorization.md#copy-iam-role)
+ [CREDENTIALS](copy-parameters-authorization.md#copy-credentials)
+ [STATUPDATE ](copy-parameters-data-load.md#copy-statupdate)
+ [MANIFEST](copy-parameters-data-source-s3.md#copy-manifest)
+ [EXPLICIT\$1IDS](copy-parameters-data-conversion.md#copy-explicit-ids)
+ Si COPY encuentra un error al cargar, el comando no se ejecuta correctamente. Los tipos de datos en columnas no aceptan ACCEPTANYDATE y MAXERROR.
+ Los mensajes de error se envían al cliente de SQL. Algunos errores se registran en STL\$1LOAD\$1ERRORS y STL\$1ERROR.
+ De manera predeterminada, COPY inserta los valores en las columnas de la tabla de destino en el mismo orden en que las columnas aparecen en los archivos de datos con formato de columna. La tabla de destino y el archivo de datos deben tener el mismo número de columnas.
+ Si el archivo que especifica para la operación COPY incluye una de las siguientes extensiones, descomprimimos los datos sin necesidad de agregar ningún parámetro:
+ `.gz`
+ `.snappy`
+ `.bz2`
+ COPY con los formatos de archivos Parquet y ORC utiliza Redshift Spectrum y el acceso al bucket. Para utilizar COPY para estos formatos, asegúrese de que no haya ninguna política de IAM que bloquee el uso de direcciones URL prefirmadas de Amazon S3. Las URL prefirmadas generadas por Amazon Redshift son válidas durante 1 hora para que Amazon Redshift tenga tiempo suficiente para cargar todos los archivos del bucket de Amazon S3. Se genera una URL prefirmada única para cada archivo escaneado mediante COPY a partir de formatos de datos en columnas. Para las políticas de bucket que incluyen una acción `s3:signatureAge`, asegúrese de establecer el valor en al menos 3 600 000 milisegundos. Para obtener más información, consulte [Uso de Amazon Redshift Spectrum con el enrutamiento de VPC mejorado](https://docs.aws.amazon.com/redshift/latest/mgmt/spectrum-enhanced-vpc.html).
+ El parámetro REGION no se admite con COPY a partir de formatos de datos en columnas. Aunque su bucket de Amazon S3 y su base de datos estén en la misma Región de AWS, puede producirse un error como, por ejemplo, REGION argument is not supported for PARQUET based COPY.
+ COPY desde formatos de columnas ahora admite el escalado simultáneo. Para habilitar el escalado simultáneo, consulte [Configuración de colas de escalado de simultaneidad](https://docs.aws.amazon.com/redshift/latest/dg/concurrency-scaling.html#concurrency-scaling-queues).
# Cadenas TIMEFORMAT y DATEFORMAT
El comando COPY utiliza las opciones DATEFORMAT y TIMEFORMAT para analizar los valores de fecha y hora de sus datos de origen. DATEFORMAT y TIMEFORMAT son cadenas formateadas que deben coincidir con el formato de los valores de fecha y hora de sus datos de origen. Por ejemplo, un comando COPY que cargue datos de origen con el valor de fecha `Jan-01-1999` debe incluir la siguiente cadena DATEFORMAT:
```
COPY ...
DATEFORMAT AS 'MON-DD-YYYY'
```
Para obtener más información sobre cómo administrar las conversiones de datos de COPY, consulte [Parámetros de conversión de datos](https://docs.aws.amazon.com/redshift/latest/dg/copy-parameters-data-conversion.html).
Las cadenas DATEFORMAT y TIMEFORMAT pueden contener separadores de fecha y hora (como “`-`”, “`/`” o “`:`”), así como los formatos datepart y timepart de la tabla siguiente.
**nota**
Si no puede hacer coincidir el formato de sus valores de fecha u hora con los siguientes formatos de datepart y timepart, o si tiene valores de fecha y hora que utilizan formatos diferentes entre sí, utilice el argumento `'auto'` con el parámetro DATEFORMAT o TIMEFORMAT. El argumento `'auto'` reconoce varios formatos que no se admiten cuando se utiliza una cadena DATEFORMAT o TIMEFORMAT. Para obtener más información, consulte [Utilización del reconocimiento automático con DATEFORMAT y TIMEFORMAT](automatic-recognition.md).
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/r_DATEFORMAT_and_TIMEFORMAT_strings.html)
El formato de fecha predeterminado es YYYY-MM-DD. El formato predeterminado de marca temporal sin zona horaria (TIMESTAMP) es AAAA-MM-DD HH:MI:SS. El formato predeterminado de marca temporal con zona horaria (TIMESTAMPTZ) es AAAA-MM-DD HH:MI:SSOF, donde OF es el desplazamiento de UTC (por ejemplo, - 8:00). No puede incluir un especificador de zona horaria (TZ, tz u OF) en timeformat\$1string. El campo de segundos (SS) también admite fracciones de segundos hasta un nivel de detalle de microsegundos. Para cargar datos TIMESTAMPTZ que estén en un formato diferente al predeterminado, especifique 'auto'.
A continuación, encontrará algunos ejemplos de fechas u horas que puede encontrar en sus datos de origen, así como las cadenas DATEFORMAT o TIMEFORMAT correspondientes.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/r_DATEFORMAT_and_TIMEFORMAT_strings.html)
## Ejemplo
Para ver un ejemplo del uso de TIMEFORMAT, consulte [Carga de una marca temporal o de fecha](r_COPY_command_examples.md#r_COPY_command_examples-load-a-time-datestamp).
# Utilización del reconocimiento automático con DATEFORMAT y TIMEFORMAT
Si especifica `'auto'` como argumento del parámetro DATEFORMAT o TIMEFORMAT, Amazon Redshift reconocerá y convertirá de forma automática el formato de fecha o de hora en los datos de origen. A continuación se muestra un ejemplo.
```
copy favoritemovies from 'dynamodb://ProductCatalog'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
dateformat 'auto';
```
Cuando se utiliza con el argumento `'auto'` para DATEFORMAT y TIMEFORMAT, COPY reconoce y convierte los formatos de fecha y hora enumerados en la tabla en [Cadenas TIMEFORMAT y DATEFORMATEjemplo](r_DATEFORMAT_and_TIMEFORMAT_strings.md). Además, el argumento `'auto'` reconoce los siguientes formatos, que no se admiten cuando se utiliza una cadena DATEFORMAT y TIMEFORMAT.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/automatic-recognition.html)
El reconocimiento automático no admite epochsecs ni epochmillisecs.
Para probar si un valor de marca temporal o fecha se convertirá automáticamente, utilice una función CAST para intentar convertir la cadena en un valor de marca temporal o fecha. Por ejemplo, los siguientes comandos prueban el valor de marca temporal `'J2345678 04:05:06.789'`:
```
create table formattest (test char(21));
insert into formattest values('J2345678 04:05:06.789');
select test, cast(test as timestamp) as timestamp, cast(test as date) as date from formattest;
test | timestamp | date
----------------------+---------------------+------------
J2345678 04:05:06.789 1710-02-23 04:05:06 1710-02-23
```
Si los datos de origen para una columna DATE incluyen información de la hora, se trunca el componente de tiempo. Si los datos de origen para una columna TIMESTAMP omiten la información de la hora, se usa 00:00:00 para el componente de tiempo.
# Ejemplos de COPY
**nota**
Estos ejemplos contienen saltos de línea por motivos de legibilidad. No incluya saltos de líneas ni espacios en la cadena *credentials-args (credenciales-argumentos)*.
**Topics**
+ [Carga de FAVORITEMOVIES de una tabla de DynamoDB](#r_COPY_command_examples-load-favoritemovies-from-an-amazon-dynamodb-table)
+ [Carga de LISTING desde un bucket de Amazon S3](#r_COPY_command_examples-load-listing-from-an-amazon-s3-bucket)
+ [Carga de LISTING desde un clúster de Amazon EMR](#copy-command-examples-emr)
+ [Example: COPY from Amazon S3 using a manifest](#copy-command-examples-manifest)
+ [Carga de LISTING de un archivo delimitado por la barra vertical (delimitador predeterminado)](#r_COPY_command_examples-load-listing-from-a-pipe-delimited-file-default-delimiter)
+ [Carga de LISTING utilizando datos en columnas con el formato de Parquet](#r_COPY_command_examples-load-listing-from-parquet)
+ [Carga de LISTING utilizando datos en columnas con el formato de ORC](#r_COPY_command_examples-load-listing-from-orc)
+ [Carga de EVENT con opciones](#r_COPY_command_examples-load-event-with-options)
+ [Carga de VENUE de un archivo de datos de ancho fijo](#r_COPY_command_examples-load-venue-from-a-fixed-width-data-file)
+ [Carga de CATEGORY de un archivo CSV](#load-from-csv)
+ [Carga de VENUE con valores explícitos para una columna IDENTITY](#r_COPY_command_examples-load-venue-with-explicit-values-for-an-identity-column)
+ [Carga de TIME de un archivo GZIP delimitado por la barra vertical](#r_COPY_command_examples-load-time-from-a-pipe-delimited-gzip-file)
+ [Carga de una marca temporal o de fecha](#r_COPY_command_examples-load-a-time-datestamp)
+ [Carga de datos de un archivo con valores predeterminados](#r_COPY_command_examples-load-data-from-a-file-with-default-values)
+ [Uso de COPY de datos con la opción ESCAPE](#r_COPY_command_examples-copy-data-with-the-escape-option)
+ [Ejemplos de Copy de JSON](#r_COPY_command_examples-copy-from-json)
+ [Ejemplos de Copy de Avro](#r_COPY_command_examples-copy-from-avro)
+ [Preparación de archivos para utilizar COPY con la opción ESCAPE](#r_COPY_preparing_data)
+ [Carga de un shapefile en Amazon Redshift](#copy-example-spatial-copy-shapefile)
+ [Comando COPY con la opción NOLOAD](#r_COPY_command_examples-load-noload-option)
+ [Comando COPY con un delimitador multibyte y la opción ENCODING](#r_COPY_command_examples-load-encoding-multibyte-delimiter-option)
## Carga de FAVORITEMOVIES de una tabla de DynamoDB
Los AWS SDK incluyen un ejemplo sencillo de la creación de una tabla de DynamoDB denominada *Movies* (Películas). (Para obtener información sobre este ejemplo, consulte [Introducción a DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GettingStarted.html)). En el siguiente ejemplo, se carga la tabla MOVIES de Amazon Redshift con los datos de la tabla de DynamoDB. La tabla de Amazon Redshift ya debe existir en la base de datos.
```
copy favoritemovies from 'dynamodb://Movies'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
readratio 50;
```
## Carga de LISTING desde un bucket de Amazon S3
En el siguiente ejemplo, se carga LISTING desde un bucket de Amazon S3. El comando COPY carga todos los archivos en la carpeta `/data/listing/`.
```
copy listing
from 's3://amzn-s3-demo-bucket/data/listing/'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole';
```
## Carga de LISTING desde un clúster de Amazon EMR
En el siguiente ejemplo, se carga la tabla SALES con datos delimitados por tabuladores de archivos comprimidos con lzop en un clúster de Amazon EMR. COPY carga cada archivo en la carpeta `myoutput/` que comienza con `part-`.
```
copy sales
from 'emr://j-SAMPLE2B500FC/myoutput/part-*'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
delimiter '\t' lzop;
```
En el siguiente ejemplo, se carga la tabla SALES con datos en formato JSON en un clúster de Amazon EMR. COPY carga cada archivo en la carpeta `myoutput/json/`.
```
copy sales
from 'emr://j-SAMPLE2B500FC/myoutput/json/'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
JSON 's3://amzn-s3-demo-bucket/jsonpaths.txt';
```
## Uso de un manifiesto para especificar archivos de datos
Puede utilizar un manifiesto para asegurarse de que el comando COPY cargue todos los archivos requeridos, y solo esos, de Amazon S3. También puede utilizar un manifiesto cuando necesite cargar varios archivos de diferentes buckets o archivos que no compartan el mismo prefijo.
Por ejemplo, suponga que necesita cargar los siguientes tres archivos: `custdata1.txt`, `custdata2.txt` y `custdata3.txt`. Puede utilizar el siguiente comando para cargar todos los archivos de `amzn-s3-demo-bucket` que comienzan con `custdata` especificando un prefijo:
```
copy category
from 's3://amzn-s3-demo-bucket/custdata'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole';
```
Si debido a un error solo existen dos de los archivos, COPY carga solo esos dos archivos y termina su ejecución correctamente, lo que se traduce en una carga de datos incompleta. Si el bucket también contiene un archivo no deseado que utiliza el mismo prefijo, como un archivo denominado `custdata.backup`, por ejemplo, COPY también carga ese archivo, lo que se traduce en una carga de datos no deseados.
Para asegurar que se carguen todos los archivos requeridos y evitar que se carguen archivos no deseados, puede utilizar un archivo de manifiesto. El manifiesto es un archivo de texto con formato JSON que enumera los archivos a procesarse por el comando COPY. Por ejemplo, el siguiente manifiesto carga los tres archivos del ejemplo anterior.
```
{
"entries":[
{
"url":"s3://amzn-s3-demo-bucket/custdata.1",
"mandatory":true
},
{
"url":"s3://amzn-s3-demo-bucket/custdata.2",
"mandatory":true
},
{
"url":"s3://amzn-s3-demo-bucket/custdata.3",
"mandatory":true
}
]
}
```
La marca opcional `mandatory` indica si COPY debe terminar en caso de que el archivo no exista. El valor predeterminado es `false`. Independientemente de cualquier configuración obligatoria, COPY termina si no se encuentran archivos. En este ejemplo, COPY devuelve un error si no se encuentra alguno de los archivos. Los archivos no deseados que podrían haberse seleccionado si se especificó solo un prefijo de clave, como `custdata.backup`, se ignoran, ya que no están en el manifiesto.
Cuando la carga se realiza a partir de archivos de datos con formato ORC o Parquet, se necesita un campo `meta`, tal y como se muestra en el siguiente ejemplo.
```
{
"entries":[
{
"url":"s3://amzn-s3-demo-bucket1/orc/2013-10-04-custdata",
"mandatory":true,
"meta":{
"content_length":99
}
},
{
"url":"s3://amzn-s3-demo-bucket2/orc/2013-10-05-custdata",
"mandatory":true,
"meta":{
"content_length":99
}
}
]
}
```
En el siguiente ejemplo, se utiliza un manifiesto llamado `cust.manifest`.
```
copy customer
from 's3://amzn-s3-demo-bucket/cust.manifest'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
format as orc
manifest;
```
Puede usar un manifiesto para cargar archivos de diferentes buckets o archivos que no compartan el mismo prefijo. En el siguiente ejemplo, se muestra el JSON para cargar datos con archivos cuyos nombres comiencen con una marca de fecha.
```
{
"entries": [
{"url":"s3://amzn-s3-demo-bucket/2013-10-04-custdata.txt","mandatory":true},
{"url":"s3://amzn-s3-demo-bucket/2013-10-05-custdata.txt","mandatory":true},
{"url":"s3://amzn-s3-demo-bucket/2013-10-06-custdata.txt","mandatory":true},
{"url":"s3://amzn-s3-demo-bucket/2013-10-07-custdata.txt","mandatory":true}
]
}
```
El manifiesto puede enumerar los archivos que se encuentran en buckets diferentes, siempre que los buckets estén en la misma región de AWS que el clúster.
```
{
"entries": [
{"url":"s3://amzn-s3-demo-bucket1/custdata1.txt","mandatory":false},
{"url":"s3://amzn-s3-demo-bucket2/custdata1.txt","mandatory":false},
{"url":"s3://amzn-s3-demo-bucket2/custdata2.txt","mandatory":false}
]
}
```
## Carga de LISTING de un archivo delimitado por la barra vertical (delimitador predeterminado)
En el siguiente ejemplo, se muestra un caso muy simple en el que no se especifican opciones y el archivo de entrada contiene el delimitador predeterminado, una barra vertical ("\$1").
```
copy listing
from 's3://amzn-s3-demo-bucket/data/listings_pipe.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole';
```
## Carga de LISTING utilizando datos en columnas con el formato de Parquet
En el siguiente ejemplo, se cargan datos desde una carpeta de Amazon S3 denominada parquet.
```
copy listing
from 's3://amzn-s3-demo-bucket/data/listings/parquet/'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
format as parquet;
```
## Carga de LISTING utilizando datos en columnas con el formato de ORC
En el siguiente ejemplo, se cargan datos desde una carpeta de Amazon S3 denominada `orc`.
```
copy listing
from 's3://amzn-s3-demo-bucket/data/listings/orc/'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
format as orc;
```
## Carga de EVENT con opciones
En el siguiente ejemplo, se cargan datos delimitados por llaves en la tabla EVENT y se aplican las siguientes reglas:
+ Si se utilizan pares de comillas para rodear cualquier cadena de caracteres, estos se eliminan.
+ Las cadenas vacías y las que contienen espacios en blanco se cargan como valores NULL.
+ La carga falla si se devuelven más de 5 errores.
+ Los valores de marca temporal deben cumplir con el formato especificado; por ejemplo, una marca temporal válida es `2008-09-26 05:43:12`.
```
copy event
from 's3://amzn-s3-demo-bucket/data/allevents_pipe.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
removequotes
emptyasnull
blanksasnull
maxerror 5
delimiter '|'
timeformat 'YYYY-MM-DD HH:MI:SS';
```
## Carga de VENUE de un archivo de datos de ancho fijo
```
copy venue
from 's3://amzn-s3-demo-bucket/data/venue_fw.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
fixedwidth 'venueid:3,venuename:25,venuecity:12,venuestate:2,venueseats:6';
```
En el ejemplo anterior se supone un archivo de datos con el mismo formato que muestran los datos de ejemplo. En la siguiente muestra, los espacios actúan como marcadores de posición para que todas las columnas tengan el mismo ancho que se indicó en la especificación:
```
1 Toyota Park Bridgeview IL0
2 Columbus Crew Stadium Columbus OH0
3 RFK Stadium Washington DC0
4 CommunityAmerica BallparkKansas City KS0
5 Gillette Stadium Foxborough MA68756
```
## Carga de CATEGORY de un archivo CSV
Suponga que desea cargar CATEGORY con los valores que se muestran en la siguiente tabla.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/r_COPY_command_examples.html)
En el siguiente ejemplo, se muestra el contenido de un archivo de texto con los valores de campo separados por comas.
```
12,Shows,Musicals,Musical theatre
13,Shows,Plays,All "non-musical" theatre
14,Shows,Opera,All opera, light, and "rock" opera
15,Concerts,Classical,All symphony, concerto, and choir concerts
```
Si carga el archivo con el parámetro DELIMITER para especificar una entrada delimitada por comas, el comando COPY falla debido a que algunos campos de entrada contienen comas. Puede evitar ese problema si utiliza el parámetro CSV y encierra los campos que contienen comas entre comillas. Si los caracteres de comillas aparecen dentro de una cadena entre comillas, deberá aplicar escape duplicando las comillas. El carácter de comilla predeterminado es la comilla doble, por lo que debe aplicar escape a cada comilla doble con una comilla doble adicional. El archivo de entrada nuevo tiene el aspecto siguiente.
```
12,Shows,Musicals,Musical theatre
13,Shows,Plays,"All ""non-musical"" theatre"
14,Shows,Opera,"All opera, light, and ""rock"" opera"
15,Concerts,Classical,"All symphony, concerto, and choir concerts"
```
Si el nombre del archivo es `category_csv.txt`, puede cargarlo con el siguiente comando COPY:
```
copy category
from 's3://amzn-s3-demo-bucket/data/category_csv.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
csv;
```
Además, para evitar la necesidad de aplicar escape a las comillas dobles de la entrada, puede especificar un carácter de comilla diferente con el parámetro QUOTE AS. Por ejemplo, la siguiente versión de `category_csv.txt` utiliza “`%`” como el carácter de comilla.
```
12,Shows,Musicals,Musical theatre
13,Shows,Plays,%All "non-musical" theatre%
14,Shows,Opera,%All opera, light, and "rock" opera%
15,Concerts,Classical,%All symphony, concerto, and choir concerts%
```
El siguiente comando COPY utiliza QUOTE AS para cargar `category_csv.txt`:
```
copy category
from 's3://amzn-s3-demo-bucket/data/category_csv.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
csv quote as '%';
```
## Carga de VENUE con valores explícitos para una columna IDENTITY
En el siguiente ejemplo, se supone que en el momento que se creó la tabla VENUE se especificó al menos una columna (como la columna `venueid`) para que sea una columna de IDENTITY. Este comando anula el comportamiento predeterminado de IDENTITY, que genera automáticamente valores para una columna IDENTITY, y en su lugar carga los valores explícitos del archivo venue.txt. Amazon Redshift no comprueba si se cargan valores IDENTITY duplicados en la tabla al utilizar la opción EXLICIT\$1IDS.
```
copy venue
from 's3://amzn-s3-demo-bucket/data/venue.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
explicit_ids;
```
## Carga de TIME de un archivo GZIP delimitado por la barra vertical
En el siguiente ejemplo, se carga la tabla TIME desde un archivo GZIP delimitado por la barra vertical:
```
copy time
from 's3://amzn-s3-demo-bucket/data/timerows.gz'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
gzip
delimiter '|';
```
## Carga de una marca temporal o de fecha
En el siguiente ejemplo, se cargan datos con una marca temporal con formato.
**nota**
El TIMEFORMAT de `HH:MI:SS` también puede admitir fracciones de segundos que sobrepasen `SS` hasta un nivel de detalle de microsegundos. El archivo `time.txt` utilizado en este ejemplo contiene una fila, `2009-01-12 14:15:57.119568`.
```
copy timestamp1
from 's3://amzn-s3-demo-bucket/data/time.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
timeformat 'YYYY-MM-DD HH:MI:SS';
```
El resultado de este copy es el siguiente:
```
select * from timestamp1;
c1
----------------------------
2009-01-12 14:15:57.119568
(1 row)
```
## Carga de datos de un archivo con valores predeterminados
En el siguiente ejemplo, se utiliza una variación de la tabla VENUE de la base de datos TICKIT. Piense en una tabla VENUE\$1NEW definida con la siguiente instrucción:
```
create table venue_new(
venueid smallint not null,
venuename varchar(100) not null,
venuecity varchar(30),
venuestate char(2),
venueseats integer not null default '1000');
```
Piense en un archivo de datos venue\$1noseats.txt que no contenga valores para la columna VENUESEATS, como se muestra en el siguiente ejemplo:
```
1|Toyota Park|Bridgeview|IL|
2|Columbus Crew Stadium|Columbus|OH|
3|RFK Stadium|Washington|DC|
4|CommunityAmerica Ballpark|Kansas City|KS|
5|Gillette Stadium|Foxborough|MA|
6|New York Giants Stadium|East Rutherford|NJ|
7|BMO Field|Toronto|ON|
8|The Home Depot Center|Carson|CA|
9|Dick's Sporting Goods Park|Commerce City|CO|
10|Pizza Hut Park|Frisco|TX|
```
La siguiente instrucción COPY cargará correctamente la tabla del archivo y aplicará el valor DEFAULT ("1000") a la columna omitida:
```
copy venue_new(venueid, venuename, venuecity, venuestate)
from 's3://amzn-s3-demo-bucket/data/venue_noseats.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
delimiter '|';
```
Ahora observe la tabla cargada:
```
select * from venue_new order by venueid;
venueid | venuename | venuecity | venuestate | venueseats
---------+----------------------------+-----------------+------------+------------
1 | Toyota Park | Bridgeview | IL | 1000
2 | Columbus Crew Stadium | Columbus | OH | 1000
3 | RFK Stadium | Washington | DC | 1000
4 | CommunityAmerica Ballpark | Kansas City | KS | 1000
5 | Gillette Stadium | Foxborough | MA | 1000
6 | New York Giants Stadium | East Rutherford | NJ | 1000
7 | BMO Field | Toronto | ON | 1000
8 | The Home Depot Center | Carson | CA | 1000
9 | Dick's Sporting Goods Park | Commerce City | CO | 1000
10 | Pizza Hut Park | Frisco | TX | 1000
(10 rows)
```
Para el siguiente ejemplo, además de suponer que no se incluyen datos de VENUESEATS en el archivo, también se supone que no se incluyen datos de VENUENAME:
```
1||Bridgeview|IL|
2||Columbus|OH|
3||Washington|DC|
4||Kansas City|KS|
5||Foxborough|MA|
6||East Rutherford|NJ|
7||Toronto|ON|
8||Carson|CA|
9||Commerce City|CO|
10||Frisco|TX|
```
Al usar la misma definición de tabla, la siguiente instrucción COPY falla ya que no se especificó ningún valor DEFAULT para VENUENAME y esta es una columna NOT NULL:
```
copy venue(venueid, venuecity, venuestate)
from 's3://amzn-s3-demo-bucket/data/venue_pipe.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
delimiter '|';
```
Ahora piense en una variación de la tabla VENUE que utilice una columna IDENTITY:
```
create table venue_identity(
venueid int identity(1,1),
venuename varchar(100) not null,
venuecity varchar(30),
venuestate char(2),
venueseats integer not null default '1000');
```
Como en el ejemplo anterior, se supone que la columna VENUESEATS no tiene valores correspondientes en el archivo de origen. La siguiente instrucción COPY carga la tabla correctamente, incluidos los valores de datos IDENTITY predefinidos en lugar de autogenerar esos valores:
```
copy venue(venueid, venuename, venuecity, venuestate)
from 's3://amzn-s3-demo-bucket/data/venue_pipe.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
delimiter '|' explicit_ids;
```
Esta instrucción falla porque no contiene la columna IDENTITY (falta VENUEID en la lista de columnas), pero incluye un parámetro EXPLICIT\$1IDS:
```
copy venue(venuename, venuecity, venuestate)
from 's3://amzn-s3-demo-bucket/data/venue_pipe.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
delimiter '|' explicit_ids;
```
Esta instrucción falla porque no contiene un parámetro EXPLICIT\$1IDS:
```
copy venue(venueid, venuename, venuecity, venuestate)
from 's3://amzn-s3-demo-bucket/data/venue_pipe.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
delimiter '|';
```
## Uso de COPY de datos con la opción ESCAPE
En el siguiente ejemplo, se muestra cómo cargar caracteres que coincidan con el carácter delimitador (en este caso, la barra vertical). En el archivo de entrada, asegúrese de que a todos los caracteres de barra vertical (\$1) que desea cargar se les aplicó el carácter de escape de barra oblicua inversa (\$1). Luego cargue el archivo con el parámetro ESCAPE.
```
$ more redshiftinfo.txt
1|public\|event\|dwuser
2|public\|sales\|dwuser
create table redshiftinfo(infoid int,tableinfo varchar(50));
copy redshiftinfo from 's3://amzn-s3-demo-bucket/data/redshiftinfo.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
delimiter '|' escape;
select * from redshiftinfo order by 1;
infoid | tableinfo
-------+--------------------
1 | public|event|dwuser
2 | public|sales|dwuser
(2 rows)
```
Sin el parámetro ESCAPE, este comando COPY producirá un error `Extra column(s) found`.
**importante**
Si carga los datos a través de un comando COPY con el parámetro ESCAPE, también debe especificar el parámetro ESCAPE con el comando UNLOAD para generar el archivo de salida recíproco. De forma similar, si utiliza UNLOAD con el parámetro ESCAPE, necesita usar ESCAPE cuando utilice COPY con los mismos datos.
## Ejemplos de Copy de JSON
En el siguiente ejemplo, cargue la tabla CATEGORY con los siguientes datos.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/r_COPY_command_examples.html)
**Topics**
+ [Carga desde datos JSON con la opción 'auto'](#copy-from-json-examples-using-auto)
+ [Carga desde datos JSON con la opción 'auto ignorecase'](#copy-from-json-examples-using-auto-ignorecase)
+ [Carga desde datos JSON con un archivo JSONPaths](#copy-from-json-examples-using-jsonpaths)
+ [Carga desde matrices de JSON con un archivo JSONPaths](#copy-from-json-examples-using-jsonpaths-arrays)
### Carga desde datos JSON con la opción 'auto'
Para cargar desde datos JSON con la opción `'auto'`, los datos JSON deben estar compuestos por un conjunto de objetos. Los nombres de clave deben coincidir con los nombres de las columnas, pero el orden no importa. A continuación se muestra el contenido de un archivo denominado `category_object_auto.json`.
```
{
"catdesc": "Major League Baseball",
"catid": 1,
"catgroup": "Sports",
"catname": "MLB"
}
{
"catgroup": "Sports",
"catid": 2,
"catname": "NHL",
"catdesc": "National Hockey League"
}
{
"catid": 3,
"catname": "NFL",
"catgroup": "Sports",
"catdesc": "National Football League"
}
{
"bogus": "Bogus Sports LLC",
"catid": 4,
"catgroup": "Sports",
"catname": "NBA",
"catdesc": "National Basketball Association"
}
{
"catid": 5,
"catgroup": "Shows",
"catname": "Musicals",
"catdesc": "All symphony, concerto, and choir concerts"
}
```
Para cargar contenido desde los archivos de datos JSON del ejemplo anterior, ejecute el siguiente comando COPY.
```
copy category
from 's3://amzn-s3-demo-bucket/category_object_auto.json'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
json 'auto';
```
### Carga desde datos JSON con la opción 'auto ignorecase'
Para cargar desde datos JSON con la opción `'auto ignorecase'`, los datos JSON deben estar compuestos por un conjunto de objetos. No es necesario que las mayúsculas y las minúsculas de los nombres de clave coincidan con los nombres de las columnas y el orden no importa. A continuación se muestra el contenido de un archivo denominado `category_object_auto-ignorecase.json`.
```
{
"CatDesc": "Major League Baseball",
"CatID": 1,
"CatGroup": "Sports",
"CatName": "MLB"
}
{
"CatGroup": "Sports",
"CatID": 2,
"CatName": "NHL",
"CatDesc": "National Hockey League"
}
{
"CatID": 3,
"CatName": "NFL",
"CatGroup": "Sports",
"CatDesc": "National Football League"
}
{
"bogus": "Bogus Sports LLC",
"CatID": 4,
"CatGroup": "Sports",
"CatName": "NBA",
"CatDesc": "National Basketball Association"
}
{
"CatID": 5,
"CatGroup": "Shows",
"CatName": "Musicals",
"CatDesc": "All symphony, concerto, and choir concerts"
}
```
Para cargar contenido desde los archivos de datos JSON del ejemplo anterior, ejecute el siguiente comando COPY.
```
copy category
from 's3://amzn-s3-demo-bucket/category_object_auto ignorecase.json'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
json 'auto ignorecase';
```
### Carga desde datos JSON con un archivo JSONPaths
Si los objetos de datos JSON no corresponden directamente con los nombres de las columnas, puede utilizar un archivo JSONPaths para asignar los elementos JSON a las columnas. El orden de los datos de origen JSON no importa, pero el orden de las expresiones del archivo JSONPaths debe coincidir con el orden de las columnas. Suponga que tiene el siguiente archivo de datos, denominado `category_object_paths.json`.
```
{
"one": 1,
"two": "Sports",
"three": "MLB",
"four": "Major League Baseball"
}
{
"three": "NHL",
"four": "National Hockey League",
"one": 2,
"two": "Sports"
}
{
"two": "Sports",
"three": "NFL",
"one": 3,
"four": "National Football League"
}
{
"one": 4,
"two": "Sports",
"three": "NBA",
"four": "National Basketball Association"
}
{
"one": 6,
"two": "Shows",
"three": "Musicals",
"four": "All symphony, concerto, and choir concerts"
}
```
El siguiente archivo JSONPaths, denominado `category_jsonpath.json`, asigna los datos de origen a las columnas de la tabla.
```
{
"jsonpaths": [
"$['one']",
"$['two']",
"$['three']",
"$['four']"
]
}
```
Para cargar contenido desde los archivos de datos JSON del ejemplo anterior, ejecute el siguiente comando COPY.
```
copy category
from 's3://amzn-s3-demo-bucket/category_object_paths.json'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
json 's3://amzn-s3-demo-bucket/category_jsonpath.json';
```
### Carga desde matrices de JSON con un archivo JSONPaths
Para cargar desde datos JSON que están compuestos por un conjunto de matrices, debe utilizar un archivo JSONPaths para asignar los elementos de las matrices a las columnas. Suponga que tiene el siguiente archivo de datos, denominado `category_array_data.json`.
```
[1,"Sports","MLB","Major League Baseball"]
[2,"Sports","NHL","National Hockey League"]
[3,"Sports","NFL","National Football League"]
[4,"Sports","NBA","National Basketball Association"]
[5,"Concerts","Classical","All symphony, concerto, and choir concerts"]
```
El siguiente archivo JSONPaths, denominado `category_array_jsonpath.json`, asigna los datos de origen a las columnas de la tabla.
```
{
"jsonpaths": [
"$[0]",
"$[1]",
"$[2]",
"$[3]"
]
}
```
Para cargar contenido desde los archivos de datos JSON del ejemplo anterior, ejecute el siguiente comando COPY.
```
copy category
from 's3://amzn-s3-demo-bucket/category_array_data.json'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
json 's3://amzn-s3-demo-bucket/category_array_jsonpath.json';
```
## Ejemplos de Copy de Avro
En el siguiente ejemplo, cargue la tabla CATEGORY con los siguientes datos.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/r_COPY_command_examples.html)
**Topics**
+ [Carga desde datos de Avro con la opción 'auto'](#copy-from-avro-examples-using-auto)
+ [Carga desde datos Avro con la opción 'auto ignorecase'](#copy-from-avro-examples-using-auto-ignorecase)
+ [Carga desde datos de Avro con un archivo JSONPaths](#copy-from-avro-examples-using-avropaths)
### Carga desde datos de Avro con la opción 'auto'
Para cargar desde datos de Avro con el argumento `'auto'`, los nombres de campo del esquema de Avro deben coincidir con los nombres de las columnas. Cuando se utiliza el argumento `'auto'`, el orden no importa. A continuación se muestra el esquema para un archivo denominado `category_auto.avro`.
```
{
"name": "category",
"type": "record",
"fields": [
{"name": "catid", "type": "int"},
{"name": "catdesc", "type": "string"},
{"name": "catname", "type": "string"},
{"name": "catgroup", "type": "string"},
}
```
Los datos del archivo de Avro están en formato binario, por lo que no son legibles. A continuación se muestra una representación de JSON de los datos del archivo `category_auto.avro`.
```
{
"catid": 1,
"catdesc": "Major League Baseball",
"catname": "MLB",
"catgroup": "Sports"
}
{
"catid": 2,
"catdesc": "National Hockey League",
"catname": "NHL",
"catgroup": "Sports"
}
{
"catid": 3,
"catdesc": "National Basketball Association",
"catname": "NBA",
"catgroup": "Sports"
}
{
"catid": 4,
"catdesc": "All symphony, concerto, and choir concerts",
"catname": "Classical",
"catgroup": "Concerts"
}
```
Para cargar contenido desde los archivos de datos Avro del ejemplo anterior, ejecute el siguiente comando COPY.
```
copy category
from 's3://amzn-s3-demo-bucket/category_auto.avro'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
format as avro 'auto';
```
### Carga desde datos Avro con la opción 'auto ignorecase'
Para cargar contenido desde datos Avro con el argumento `'auto ignorecase'`, no es necesario que las mayúsculas y las minúsculas de los nombres de campo del esquema de Avro coincidan con las mayúsculas y las minúsculas de los nombres de las columnas. Cuando se utiliza el argumento `'auto ignorecase'`, el orden no importa. A continuación se muestra el esquema para un archivo denominado `category_auto-ignorecase.avro`.
```
{
"name": "category",
"type": "record",
"fields": [
{"name": "CatID", "type": "int"},
{"name": "CatDesc", "type": "string"},
{"name": "CatName", "type": "string"},
{"name": "CatGroup", "type": "string"},
}
```
Los datos del archivo de Avro están en formato binario, por lo que no son legibles. A continuación se muestra una representación de JSON de los datos del archivo `category_auto-ignorecase.avro`.
```
{
"CatID": 1,
"CatDesc": "Major League Baseball",
"CatName": "MLB",
"CatGroup": "Sports"
}
{
"CatID": 2,
"CatDesc": "National Hockey League",
"CatName": "NHL",
"CatGroup": "Sports"
}
{
"CatID": 3,
"CatDesc": "National Basketball Association",
"CatName": "NBA",
"CatGroup": "Sports"
}
{
"CatID": 4,
"CatDesc": "All symphony, concerto, and choir concerts",
"CatName": "Classical",
"CatGroup": "Concerts"
}
```
Para cargar contenido desde los archivos de datos Avro del ejemplo anterior, ejecute el siguiente comando COPY.
```
copy category
from 's3://amzn-s3-demo-bucket/category_auto-ignorecase.avro'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
format as avro 'auto ignorecase';
```
### Carga desde datos de Avro con un archivo JSONPaths
Si los nombres de campo del esquema de Avro no corresponden directamente con los nombres de las columnas, puede utilizar un archivo JSONPaths para asignar los elementos del esquema a las columnas. El orden de las expresiones del archivo JSONPaths debe coincidir con el orden de las columnas.
Suponga que tiene un archivo de datos denominado `category_paths.avro` que contiene los mismos datos que el ejemplo anterior, pero con el siguiente esquema.
```
{
"name": "category",
"type": "record",
"fields": [
{"name": "id", "type": "int"},
{"name": "desc", "type": "string"},
{"name": "name", "type": "string"},
{"name": "group", "type": "string"},
{"name": "region", "type": "string"}
]
}
```
El siguiente archivo JSONPaths, denominado `category_path.avropath`, asigna los datos de origen a las columnas de la tabla.
```
{
"jsonpaths": [
"$['id']",
"$['group']",
"$['name']",
"$['desc']"
]
}
```
Para cargar contenido desde los archivos de datos Avro del ejemplo anterior, ejecute el siguiente comando COPY.
```
copy category
from 's3://amzn-s3-demo-bucket/category_object_paths.avro'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
format avro 's3://amzn-s3-demo-bucket/category_path.avropath ';
```
## Preparación de archivos para utilizar COPY con la opción ESCAPE
En el siguiente ejemplo, se describe cómo puede preparar datos para “aplicar escape” a los caracteres de línea nueva antes de importar los datos a una tabla de Amazon Redshift mediante el comando COPY con el parámetro ESCAPE. Sin la preparación de los datos para delimitar los caracteres de línea nueva, Amazon Redshift devuelve errores de carga cuando ejecuta el comando COPY, ya que el carácter de línea nueva, por lo general, se utiliza como un separador de registros.
Por ejemplo, piense en un archivo o una columna de una tabla externa que desea copiar a una tabla de Amazon Redshift. Si el archivo o la columna tiene contenido con formato XML o datos similares, debe asegurarse de que a todos los caracteres de línea nueva (\$1n) que forman parte del contenido se les aplique escape con la barra oblicua inversa (\$1).
Un archivo o una tabla que contienen caracteres de línea nueva insertados proporcionan un patrón relativamente fácil para el cual buscar coincidencias. Lo más probable es que cada carácter de línea nueva insertado siga siempre a un carácter `>` con algunos caracteres de espacio en blanco potenciales (`' '` o tabulación) en el medio, como se puede observar en el siguiente ejemplo de un archivo de texto denominado `nlTest1.txt`.
```
$ cat nlTest1.txt
|1000
|2000
```
Con el siguiente ejemplo, puede ejecutar un procesador de textos para procesar previamente el archivo de origen e insertar caracteres de escape cuando los necesite. (El carácter `|` está pensado para utilizarse como delimitador para separar datos de columnas cuando se copian en una tabla de Amazon Redshift).
```
$ sed -e ':a;N;$!ba;s/>[[:space:]]*\n/>\\\n/g' nlTest1.txt > nlTest2.txt
```
Del mismo modo, puede utilizar Perl para realizar una operación similar:
```
cat nlTest1.txt | perl -p -e 's/>\s*\n/>\\\n/g' > nlTest2.txt
```
Para adaptar la carga de datos del archivo `nlTest2.txt` en Amazon Redshift, creamos una tabla con dos columnas en dicho servicio. La primera columna c1, es una columna de caracteres que tiene el contenido con formato XML del archivo `nlTest2.txt`. La segunda columna c2 contiene los valores enteros cargados desde el mismo archivo.
Después de ejecutar el comando `sed`, puede cargar correctamente los datos del archivo `nlTest2.txt` en una tabla de Amazon Redshift mediante el parámetro ESCAPE.
**nota**
Cuando incluya el parámetro ESCAPE con el comando COPY, se aplica escape a un número de caracteres especiales que incluyen la barra oblicua inversa (incluida la línea nueva).
```
copy t2 from 's3://amzn-s3-demo-bucket/data/nlTest2.txt'
iam_role 'arn:aws:iam::0123456789012:role/MyRedshiftRole'
escape
delimiter as '|';
select * from t2 order by 2;
c1 | c2
-------------+------
| 1000
| 2000
(2 rows)
```
Puede preparar los archivos de datos exportados de bases de datos externas de forma similar. Por ejemplo, con una base de datos de Oracle, puede utilizar la función REPLACE en cada columna afectada de una tabla que desee copiar en Amazon Redshift.
```
SELECT c1, REPLACE(c2, \n',\\n' ) as c2 from my_table_with_xml
```
Además, varias herramientas de extracción, transformación y carga (ETL) y de exportación de bases de datos que generalmente procesan grandes cantidades de datos brindan opciones para especificar caracteres delimitadores y de escape.
## Carga de un shapefile en Amazon Redshift
En los siguientes ejemplos, se muestra cómo cargar un ESRI shapefile con COPY. Para obtener más información sobre cómo cargar shapefiles, consulte [Carga de un shapefile en Amazon Redshift](spatial-copy-shapefile.md).
### Carga de un shapefile
Los siguientes pasos muestran cómo capturar datos de OpenStreetMap desde Amazon S3 a través del comando COPY. Este ejemplo asume que el archivo shapefile de Noruega del [sitio de descarga de Geofabrik](https://download.geofabrik.de/europe.html) se cargó en un bucket de Amazon S3 privado en su región de AWS. Los archivos `.shp`, `.shx` y `.dbf` deben compartir el mismo prefijo y nombre de archivo de Amazon S3.
#### Ingesta de datos sin simplificación
Los siguientes comandos crean tablas y capturan datos que caben en el tamaño máximo de geometría sin ninguna simplificación. Abra `gis_osm_natural_free_1.shp` en su software de SIG preferido e inspeccione las columnas de esta capa. De manera predeterminada, las columnas IDENTITY o GEOMETRY son las primeras. Cuando una columna GEOMETRY es la primera, puede crear la tabla como se muestra a continuación.
```
CREATE TABLE norway_natural (
wkb_geometry GEOMETRY,
osm_id BIGINT,
code INT,
fclass VARCHAR,
name VARCHAR);
```
Cuando una columna IDENTITY es la primera, puede crear la tabla como se muestra a continuación.
```
CREATE TABLE norway_natural_with_id (
fid INT IDENTITY(1,1),
wkb_geometry GEOMETRY,
osm_id BIGINT,
code INT,
fclass VARCHAR,
name VARCHAR);
```
Ahora, puede capturar los datos mediante COPY.
```
COPY norway_natural FROM 's3://bucket_name/shapefiles/norway/gis_osm_natural_free_1.shp'
FORMAT SHAPEFILE
CREDENTIALS 'aws_iam_role=arn:aws:iam::123456789012:role/MyRoleName';
INFO: Load into table 'norway_natural' completed, 83891 record(s) loaded successfully
```
También puede capturar los datos como se muestra a continuación.
```
COPY norway_natural_with_id FROM 's3://bucket_name/shapefiles/norway/gis_osm_natural_free_1.shp'
FORMAT SHAPEFILE
CREDENTIALS 'aws_iam_role=arn:aws:iam::123456789012:role/MyRoleName';
INFO: Load into table 'norway_natural_with_id' completed, 83891 record(s) loaded successfully.
```
#### Ingesta de datos con simplificación
Los siguientes comandos crean una tabla e intentan capturar datos que no caben en el tamaño máximo de la geometría sin ninguna simplificación. Inspeccione el shapefile `gis_osm_water_a_free_1.shp` y cree la tabla adecuada como se muestra a continuación.
```
CREATE TABLE norway_water (
wkb_geometry GEOMETRY,
osm_id BIGINT,
code INT,
fclass VARCHAR,
name VARCHAR);
```
Cuando se ejecuta el comando COPY, se produce un error.
```
COPY norway_water FROM 's3://bucket_name/shapefiles/norway/gis_osm_water_a_free_1.shp'
FORMAT SHAPEFILE
CREDENTIALS 'aws_iam_role=arn:aws:iam::123456789012:role/MyRoleName';
ERROR: Load into table 'norway_water' failed. Check 'stl_load_errors' system table for details.
```
La consulta de `STL_LOAD_ERRORS` muestra que la geometría es demasiado grande.
```
SELECT line_number, btrim(colname), btrim(err_reason) FROM stl_load_errors WHERE query = pg_last_copy_id();
line_number | btrim | btrim
-------------+--------------+-----------------------------------------------------------------------
1184705 | wkb_geometry | Geometry size: 1513736 is larger than maximum supported size: 1048447
```
Para superar esto, el parámetro `SIMPLIFY AUTO` se agrega al comando COPY para simplificar la geometría.
```
COPY norway_water FROM 's3://bucket_name/shapefiles/norway/gis_osm_water_a_free_1.shp'
FORMAT SHAPEFILE
SIMPLIFY AUTO
CREDENTIALS 'aws_iam_role=arn:aws:iam::123456789012:role/MyRoleName';
INFO: Load into table 'norway_water' completed, 1989196 record(s) loaded successfully.
```
Para ver las filas y las geometrías que se simplificaron, consulte `SVL_SPATIAL_SIMPLIFY`.
```
SELECT * FROM svl_spatial_simplify WHERE query = pg_last_copy_id();
query | line_number | maximum_tolerance | initial_size | simplified | final_size | final_tolerance
-------+-------------+-------------------+--------------+------------+------------+----------------------
20 | 1184704 | -1 | 1513736 | t | 1008808 | 1.276386653895e-05
20 | 1664115 | -1 | 1233456 | t | 1023584 | 6.11707814796635e-06
```
El uso de SIMPLIFY AUTO *max\$1tolerance* con una tolerancia inferior a las calculadas de manera automática probablemente resulte en un error de ingesta. En este caso, utilice MAXERROR para ignorar los errores.
```
COPY norway_water FROM 's3://bucket_name/shapefiles/norway/gis_osm_water_a_free_1.shp'
FORMAT SHAPEFILE
SIMPLIFY AUTO 1.1E-05
MAXERROR 2
CREDENTIALS 'aws_iam_role=arn:aws:iam::123456789012:role/MyRoleName';
INFO: Load into table 'norway_water' completed, 1989195 record(s) loaded successfully.
INFO: Load into table 'norway_water' completed, 1 record(s) could not be loaded. Check 'stl_load_errors' system table for details.
```
Consulte `SVL_SPATIAL_SIMPLIFY` de nuevo para identificar el registro que COPY no logró cargar.
```
SELECT * FROM svl_spatial_simplify WHERE query = pg_last_copy_id();
query | line_number | maximum_tolerance | initial_size | simplified | final_size | final_tolerance
-------+-------------+-------------------+--------------+------------+------------+-----------------
29 | 1184704 | 1.1e-05 | 1513736 | f | 0 | 0
29 | 1664115 | 1.1e-05 | 1233456 | t | 794432 | 1.1e-05
```
En este ejemplo, el primer registro no logró ajustarse; por lo tanto, la columna `simplified` se muestra como false. El segundo registro se cargó en el marco de la tolerancia determinada. No obstante, el tamaño final es mayor que si se utiliza la tolerancia calculada automáticamente sin especificar la tolerancia máxima.
### Carga desde un shapefile comprimido
COPY de Amazon Redshift admite la ingesta de datos de un shapefile comprimido. Todos los componentes de shapefile deben tener el mismo prefijo de Amazon S3 y el mismo sufijo de compresión. Por ejemplo, supongamos que desea cargar los datos del ejemplo anterior. En este caso, los archivos `gis_osm_water_a_free_1.shp.gz`, `gis_osm_water_a_free_1.dbf.gz` y `gis_osm_water_a_free_1.shx.gz` deben compartir el directorio de Amazon S3. El comando COPY requiere la opción GZIP, y la cláusula FROM debe especificar el archivo comprimido correcto, como se muestra a continuación.
```
COPY norway_natural FROM 's3://bucket_name/shapefiles/norway/compressed/gis_osm_natural_free_1.shp.gz'
FORMAT SHAPEFILE
GZIP
CREDENTIALS 'aws_iam_role=arn:aws:iam::123456789012:role/MyRoleName';
INFO: Load into table 'norway_natural' completed, 83891 record(s) loaded successfully.
```
### Carga de datos en una tabla con un orden de columnas diferente
Si tiene una tabla en la que `GEOMETRY` no es la primera columna, puede utilizar el mapeo de columnas para asignar columnas a la tabla de destino. Por ejemplo, cree una tabla con `osm_id` especificado como primera columna.
```
CREATE TABLE norway_natural_order (
osm_id BIGINT,
wkb_geometry GEOMETRY,
code INT,
fclass VARCHAR,
name VARCHAR);
```
Luego, capture un shapefile mediante el mapeo de columnas.
```
COPY norway_natural_order(wkb_geometry, osm_id, code, fclass, name)
FROM 's3://bucket_name/shapefiles/norway/gis_osm_natural_free_1.shp'
FORMAT SHAPEFILE
CREDENTIALS 'aws_iam_role=arn:aws:iam::123456789012:role/MyRoleName';
INFO: Load into table 'norway_natural_order' completed, 83891 record(s) loaded successfully.
```
### Carga de datos en una tabla con una columna geography
Si tiene una tabla con una columna `GEOGRAPHY`, primero captúrela en una columna `GEOMETRY` y, a continuación, convierta los objetos en objetos `GEOGRAPHY`. Por ejemplo, después de copiar el shapefile en una columna `GEOMETRY`, modifique la tabla para agregar una columna de tipo de datos `GEOGRAPHY`.
```
ALTER TABLE norway_natural ADD COLUMN wkb_geography GEOGRAPHY;
```
A continuación, convierta las columnas geometry en geography.
```
UPDATE norway_natural SET wkb_geography = wkb_geometry::geography;
```
De forma opcional, puede eliminar la columna `GEOMETRY`.
```
ALTER TABLE norway_natural DROP COLUMN wkb_geometry;
```
## Comando COPY con la opción NOLOAD
Para validar los archivos de datos antes de que los datos se carguen, use la opción NOLOAD con el comando COPY. Amazon Redshift analiza el archivo de entrada y muestra los errores que se producen. En el siguiente ejemplo se utiliza la opción NOLOAD donde no se carga ninguna fila en la tabla.
```
COPY public.zipcode1
FROM 's3://amzn-s3-demo-bucket/mydata/zipcode.csv'
DELIMITER ';'
IGNOREHEADER 1 REGION 'us-east-1'
NOLOAD
CREDENTIALS 'aws_iam_role=arn:aws:iam::123456789012:role/myRedshiftRole';
Warnings:
Load into table 'zipcode1' completed, 0 record(s) loaded successfully.
```
## Comando COPY con un delimitador multibyte y la opción ENCODING
En el siguiente ejemplo, se carga LATIN1 desde un archivo de Amazon S3 que contiene datos multibyte. El comando COPY especifica el delimitador en formato octal `\302\246\303\254` para separar los campos del archivo de entrada, que está codificado como ISO-8859-1. Para especificar el mismo delimitador en UTF-8, indique `DELIMITER '¦ì'`.
```
COPY latin1
FROM 's3://amzn-s3-demo-bucket/multibyte/myfile'
IAM_ROLE 'arn:aws:iam::123456789012:role/myRedshiftRole'
DELIMITER '\302\246\303\254'
ENCODING ISO88591
```
# CREATE DATABASE
Crea una nueva base de datos.
Para crear una base de datos, debe ser un superusuario o tener el privilegio CREATEDB. Para crear una base de datos asociada a una integración sin ETL, debe ser un superusuario o tener los privilegios CREATEDB y CREATEUSER.
No se puede ejecutar CREATE DATABASE en un bloque de transacción (BEGIN ... END). Para obtener más información acerca de las transacciones, consulte [Niveles de aislamiento en Amazon Redshift](c_serial_isolation.md).
## Sintaxis
```
CREATE DATABASE database_name
[ { [
FROM INTEGRATION ''[ DATABASE '' ]
[ SET ]
[ ACCEPTINVCHARS [=] { TRUE | FALSE }]
[ QUERY_ALL_STATES [=] { TRUE | FALSE }]
[ REFRESH_INTERVAL ]
[ TRUNCATECOLUMNS [=] { TRUE | FALSE } ]
[ HISTORY_MODE [=] {TRUE | FALSE} ]
]
[ WITH ]
[ OWNER [=] db_owner ]
[ CONNECTION LIMIT { limit | UNLIMITED } ]
[ COLLATE { CASE_SENSITIVE | CS | CASE_INSENSITIVE | CI } ]
[ ISOLATION LEVEL { SNAPSHOT | SERIALIZABLE } ]
}
| { FROM { { ARN '' } { WITH DATA CATALOG SCHEMA '' | WITH NO DATA CATALOG SCHEMA } } }
| { IAM_ROLE {default | 'SESSION' | 'arn:aws:iam:::role/' } }
| { [ WITH PERMISSIONS ] FROM DATASHARE datashare_name OF [ ACCOUNT account_id ] NAMESPACE namespace_guid }
]
```
## Parameters
*database\$1name*
Nombre de la nueva base de datos. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
FROM INTEGRATION '' [ DATABASE '' ]
Especifica si se debe crear la base de datos mediante un identificador de integración sin ETL. Puede recuperar `integration_id` de la vista del sistema SVV\$1INTEGRATION. Para las integraciones sin ETL de Aurora PostgreSQL, también debe especificar el nombre de `source_database`, que también se puede recuperar de SVV\$1INTEGRATION.
Para ver un ejemplo, consulta [Creación de bases de datos para recibir los resultados de las integraciones sin ETL](#r_CREATE_DATABASE-integration). Para obtener más información sobre la creación de bases de datos con integraciones sin ETL, consulte [Creación de bases de datos de destino en Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/zero-etl-using.creating-db.html) en la *Guía de administración de Amazon Redshift*.
SET
Palabra clave opcional.
ACCEPTINVCHARS [=] \$1 TRUE \$1 FALSE \$1
La cláusula ACCEPTINVCHARS establece si las tablas de integración sin ETL continúan con la ingesta cuando se detectan caracteres no válidos para el tipo de datos VARCHAR. Cuando se encuentran caracteres no válidos, se reemplazan por un carácter `?` predeterminado.
QUERY\$1ALL\$1STATES [=] \$1 TRUE \$1 FALSE \$1
La cláusula QUERY\$1ALL\$1STATES establece si las tablas de integración sin ETL pueden consultarse en todos los estados (`Synced`, `Failed`, `ResyncRequired` y `ResyncInitiated`). De forma predeterminada, una tabla de integración sin ETL solo puede consultarse en estado `Synced`.
REFRESH\$1INTERVAL
La cláusula REFRESH\$1INTERVAL establece el intervalo de tiempo aproximado, en segundos, para actualizar los datos desde el origen sin ETL en la base de datos de destino. El valor se puede establecer de 0 a 432 000 segundos (5 días) para las integraciones sin ETL cuyo tipo de origen sea Aurora MySQL, Aurora PostgreSQL o RDS para MySQL. Para las integraciones sin ETL de Amazon DynamoDB, el valor se puede establecer entre 900 y 432 000 segundos (15 minutos y 5 días). El `interval` predeterminado es cero (0) segundos para las integraciones sin ETL cuyo tipo de origen sea Aurora MySQL, Aurora PostgreSQL o RDS para MySQL. Para las integraciones sin ETL de Amazon DynamoDB, el `interval` predeterminado es de 900 segundos (15 minutos).
TRUNCATECOLUMNS [=] \$1 TRUE \$1 FALSE \$1
La cláusula TRUNCATECOLUMNS establece si las tablas de integración sin ETL continúan con la ingesta cuando los valores de la columna VARCHAR o los atributos de columna SUPER exceden el límite. Cuando `TRUE`, los valores se truncan para que quepan en la columna y los valores de los atributos JSON desbordados se truncan para que quepan en la columna SUPER.
HISTORY\$1MODE [=] \$1TRUE \$1 FALSE\$1
Cláusula que especifica si Amazon Redshift establecerá el modo de historial para todas las tablas nuevas de la base de datos especificada. Esta opción solo se aplica a las bases de datos creadas para la integración sin ETL.
La cláusula HISTORY\$1MODE puede establecerse en `TRUE` o `FALSE`. El valor predeterminado es `FALSE`. Para obtener información sobre HISTORY\$1MODE, consulte [Modo de historial](https://docs.aws.amazon.com/redshift/latest/mgmt/zero-etl-history-mode.html) en la *Guía de administración de Amazon Redshift*.
WITH
Palabra clave opcional.
OWNER [=] db\$1owner
Especifica el nombre de usuario del propietario de la base de datos.
CONNECTION LIMIT \$1 *limit* \$1 UNLIMITED \$1
La cantidad máxima de conexiones a la base de datos que los usuarios pueden tener abiertas al mismo tiempo. Este límite no se aplica a los superusuarios. Use la palabra clave UNLIMITED para permitir la cantidad máxima de conexiones simultáneas. También puede aplicarse un límite de la cantidad de conexiones de cada usuario. Para obtener más información, consulte [CREATE USER](r_CREATE_USER.md). El valor predeterminado es UNLIMITED. Para ver las conexiones actuales, consulte la vista del sistema [STV\$1SESSIONS](r_STV_SESSIONS.md).
Si se aplican los límites de conexión tanto para usuarios como para bases de datos, debe haber una ranura de conexión sin utilizar disponible dentro de ambos límites cuando un usuario intenta conectarse.
COLLATE \$1 CASE\$1SENSITIVE \$1 CS \$1 CASE\$1INSENSITIVE \$1 CI \$1
Una cláusula que especifica si en la búsqueda o comparación de cadenas se distingue entre mayúsculas y minúsculas. El valor predeterminado es distinguir entre mayúsculas y minúsculas.
No se admite la intercalación cuando se crea una base de datos a partir de un recurso compartido de datos.
CASE\$1SENSITIVE y CS son intercambiables y producen los mismos resultados. Del mismo modo, CASE\$1INSENSITIVE y CI son intercambiables y producen los mismos resultados.
ISOLATION LEVEL \$1 SNAPSHOT \$1 SERIALIZABLE \$1
Una cláusula que especifica el nivel de aislamiento utilizado cuando las consultas se ejecutan en una base de datos. Para obtener más información sobre niveles de aislamiento, consulte [Niveles de aislamiento en Amazon Redshift](c_serial_isolation.md).
+ Aislamiento SNAPSHOT: proporciona un nivel de aislamiento con protección contra conflictos de actualización y eliminación. Es el valor predeterminado para una base de datos creada en un clúster aprovisionado o espacio de nombres sin servidor.
+ Aislamiento SERIALIZABLE: proporciona serialización completa para transacciones simultáneas.
FROM ARN ''
ARN de base de datos de AWS Glue que se puede utilizar para crear la base de datos.
\$1 WITH DATA CATALOG SCHEMA '' \$1 WITH NO DATA CATALOG SCHEMA \$1
Este parámetro solo se puede aplicar si el comando CREATE DATABASE también utiliza el parámetro FROM ARN.
Especifica si se va a crear la base de datos mediante un esquema para acceder a los objetos de AWS Glue Data Catalog.
IAM\$1ROLE \$1 default \$1 'SESSION' \$1 'arn:aws:iam::**:role/**' \$1
Este parámetro solo se puede aplicar si el comando CREATE DATABASE también utiliza el parámetro FROM ARN.
Si especifica un rol de IAM asociado al clúster al ejecutar el comando CREATE DATABASE, Amazon Redshift utilizará las credenciales del rol cuando ejecute consultas en la base de datos.
Especificar la palabra clave `default` significa utilizar el rol de IAM establecido como predeterminado y asociado al clúster.
Use `'SESSION'` si se conecta al clúster de Amazon Redshift mediante una identidad federada y acceda a las tablas desde el esquema externo creado con este comando. Para ver un ejemplo de utilización de una identidad federada, consulte [Uso de una identidad federada para administrar el acceso de Amazon Redshift a los recursos locales y a las tablas externas de Amazon Redshift Spectrum](https://docs.aws.amazon.com/redshift/latest/mgmt/authorization-fas-spectrum.html), lo que explica cómo configurar la identidad federada.
Utilice el nombre de recurso de Amazon (ARN), de un rol de IAM que el clúster utiliza para la autenticación y la autorización. Como mínimo, el rol de IAM debe tener permiso para realizar una operación LIST en el bucket de Amazon S3 al que se accederá y una operación GET en los objetos de Amazon S3 que el bucket contiene. Para obtener más información sobre cómo utilizar IAM\$1ROLE al crear una base de datos que utilice AWS Glue Data Catalog para los recursos compartidos de datos, consulte [Uso de recursos compartidos de datos administrados por Lake Formation como consumidor](https://docs.aws.amazon.com/redshift/latest/dg/lake-formation-getting-started-consumer.html).
A continuación se muestra la sintaxis de la cadena del parámetro IAM\$1ROLE para un único ARN.
```
IAM_ROLE 'arn:aws:iam:::role/'
```
Puede encadenar roles para que el clúster pueda asumir otro rol de IAM, que posiblemente pertenezca a otra cuenta. Puede encadenar hasta 10 roles. Para obtener más información, consulte [Encadenamiento de roles de IAM en Amazon Redshift Spectrum](c-spectrum-iam-policies.md#c-spectrum-chaining-roles).
Para este rol de IAM; asocie una política de permisos de IAM similar a la siguiente.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AccessSecret",
"Effect": "Allow",
"Action": [
"secretsmanager:GetResourcePolicy",
"secretsmanager:GetSecretValue",
"secretsmanager:DescribeSecret",
"secretsmanager:ListSecretVersionIds"
],
"Resource": "arn:aws:secretsmanager:us-west-2:123456789012:secret:my-rds-secret-VNenFy"
},
{
"Sid": "VisualEditor1",
"Effect": "Allow",
"Action": [
"secretsmanager:GetRandomPassword",
"secretsmanager:ListSecrets"
],
"Resource": "*"
}
]
}
```
Para obtener información sobre los pasos para crear un rol de IAM que se utilizará con la consulta federada, consulte [Creación de un secreto y rol de IAM para utilizar consultas federadas](federated-create-secret-iam-role.md).
No incluya espacios en la lista de roles encadenados.
A continuación se muestra la sintaxis para encadenar tres roles.
```
IAM_ROLE 'arn:aws:iam:::role/,arn:aws:iam:::role/,arn:aws:iam:::role/'
```
## Sintaxis para utilizar CREATE DATABASE con un datashare
La siguiente sintaxis describe el comando CREATE DATABASE que se utiliza para crear bases de datos a partir de un recurso compartido de datos para compartir datos dentro de la misma cuenta de AWS.
```
CREATE DATABASE database_name
[ [ WITH PERMISSIONS ] FROM DATASHARE datashare_name OF [ ACCOUNT account_id ] NAMESPACE namespace_guid
```
La siguiente sintaxis describe el comando CREATE DATABASE que se utiliza para crear bases de datos a partir de un recurso compartido de datos, para compartir datos entre cuentas de AWS.
```
CREATE DATABASE database_name
[ [ WITH PERMISSIONS ] FROM DATASHARE datashare_name OF ACCOUNT account_id NAMESPACE namespace_guid
```
### Parámetros para utilizar CREATE DATABASE con un datashare
FROM DATASHARE
Se trata de una palabra clave que indica dónde está ubicado el datashare.
*datashare\$1name*
Se trata del nombre del datashare en el que se crea la base de datos consumidora.
WITH PERMISSIONS
Especifica que la base de datos creada a partir del recurso compartido de datos requiere permisos de nivel de objeto para acceder a los objetos individuales de la base de datos. Sin esta cláusula, los usuarios o roles a los que se conceda el permiso USAGE en la base de datos tendrán acceso automáticamente a todos los objetos de la base de datos.
NAMESPACE *namespace\$1guid*
Se trata de un valor que especifica el espacio de nombres productor al que pertenece el recurso compartido de datos.
ACCOUNT *account\$1id*
Se trata de un valor que especifica la cuenta productora a la que pertenece el recurso compartido de datos.
## Notas de uso para CREATE DATABASE en el uso compartido de datos
Como superusuario de base de datos, cuando utilice CREATE DATABASE para crear bases de datos a partir de recursos compartidos de datos en la cuenta de AWS, especifique la opción NAMESPACE. La opción ACCOUNT es opcional. Cuando utilice CREATE DATABASE para crear bases de datos a partir de recursos compartidos de datos entre las cuentas de AWS, especifique las opciones ACCOUNT y NAMESPACE desde el productor.
Solo puede crear una base de datos consumidora para un recurso compartido de datos en un clúster consumidor. No se pueden crear varias bases de datos consumidoras que hagan referencia al mismo recurso compartido de datos.
## CREATE DATABASE desde AWS Glue Data Catalog
Para crear una base de datos mediante un ARN de base de datos de AWS Glue, especifique el ARN en el comando CREATE DATABASE.
```
CREATE DATABASE sampledb FROM ARN WITH NO DATA CATALOG SCHEMA;
```
Si lo desea, también puede suministrar un valor en el parámetro IAM\$1ROLE. Para obtener más información sobre el parámetro y los valores aceptados, consulte [Parámetros](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_DATABASE.html#r_CREATE_DATABASE-parameters).
A continuación, se muestran ejemplos que demuestran cómo crear una base de datos a partir de un ARN mediante un rol de IAM.
```
CREATE DATABASE sampledb FROM ARN WITH NO DATA CATALOG SCHEMA IAM_ROLE
```
```
CREATE DATABASE sampledb FROM ARN WITH NO DATA CATALOG SCHEMA IAM_ROLE default;
```
También puede crear una base de datos mediante DATA CATALOG SCHEMA.
```
CREATE DATABASE sampledb FROM ARN WITH DATA CATALOG SCHEMA IAM_ROLE default;
```
## Creación de bases de datos para recibir los resultados de las integraciones sin ETL
Para crear una base de datos mediante una identidad de integración sin ETL, especifique `integration_id` en el comando CREATE DATABASE.
```
CREATE DATABASE destination_db_name FROM INTEGRATION 'integration_id';
```
Por ejemplo, primero, recupere los identificadores de integración de SVV\$1INTEGRATION;
```
SELECT integration_id FROM SVV_INTEGRATION;
```
A continuación, utilice uno de los identificadores de integración recuperados para crear la base de datos que recibe integraciones sin ETL.
```
CREATE DATABASE sampledb FROM INTEGRATION 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111';
```
Si se necesita la base de datos de origen de integraciones sin ETL, por ejemplo, especifique.
```
CREATE DATABASE sampledb FROM INTEGRATION 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111' DATABASE sourcedb;
```
También puede establecer un intervalo de actualización para la base de datos. Por ejemplo, para establecer el intervalo de actualización en 7200 segundos para los datos de un origen de integración sin ETL:
```
CREATE DATABASE myacct_mysql FROM INTEGRATION 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111' SET REFRESH_INTERVAL 7200;
```
Consulte la vista de catálogo de SVV\$1INTEGRATION para obtener información sobre una integración sin ETL, como integration\$1id, target\$1database, origen, refresh\$1interval, etc.
```
SELECT * FROM svv_integration;
```
En el siguiente ejemplo se crea una base de datos a partir de una integración con el modo de historial activado.
```
CREATE DATABASE sample_integration_db FROM INTEGRATION 'a1b2c3d4-5678-90ab-cdef-EXAMPLE11111' SET HISTORY_MODE = true;
```
## Límites de CREATE DATABASE
Amazon Redshift aplica estos límites para las bases de datos:
+ Máximo de 60 bases de datos definidas por el usuario por clúster.
+ Máximo de 127 bytes para un nombre de base de datos.
+ El nombre de una base de datos no puede ser una palabra reservada.
## Intercalación de bases de datos
La intercalación representa un conjunto de reglas que define la forma en que el motor de base de datos compara y ordena los datos del tipo caracteres en SQL. La intercalación sin distinción entre mayúsculas y minúsculas es la utilizada con más frecuencia. Amazon Redshift utiliza intercalación sin distinción entre mayúsculas y minúsculas para facilitar la migración desde otros sistemas de almacenamiento de datos. Gracias a la compatibilidad nativa con la intercalación sin distinción entre mayúsculas y minúsculas, Amazon Redshift sigue utilizando importantes métodos de ajuste u optimización, como claves de distribución, claves de ordenación o análisis de rango restringido.
La cláusula COLLATE especifica la intercalación predeterminada para todas las columnas CHAR y VARCHAR de la base de datos. Si se especifica CASE\$1INSENSITIVE, todas las columnas CHAR o VARCHAR utilizan la intercalación sin distinción entre mayúsculas y minúsculas. Para obtener información acerca de la intercalación, consulte [Secuencias de intercalación](c_collation_sequences.md).
Los datos insertados o capturados en columnas donde no se distingue entre mayúsculas y minúsculas conservarán el formato original. No obstante, todas las operaciones de cadenas basadas en la comparación, incluidas la ordenación y la agrupación, no distinguirán entre mayúsculas y minúsculas. Las operaciones de búsqueda de coincidencias de patrones, como los predicados LIKE, similares a las funciones de expresión comunes y las propias funciones tampoco distinguirán entre mayúsculas y minúsculas.
Las siguientes operaciones de SQL son compatibles con la semántica de intercalación aplicable:
+ operadores de comparación: =, <>, <, <=, >, >=
+ operador LIKE
+ cláusulas ORDER BY
+ cláusulas GROUP BY
+ funciones de agrupación que utilizan la comparación de cadenas, como MIN, MAX y LISTAGG
+ funciones de ventana, como las cláusulas PARTITION BY y las cláusulas ORDER BY
+ funciones escalares greatest() y least(), STRPOS(), REGEXP\$1COUNT(), REGEXP\$1REPLACE(), REGEXP\$1INSTR(), REGEXP\$1SUBSTR()
+ cláusula Distinct
+ UNION, INTERSECT y EXCEPT
+ IN LIST
Para las consultas externas, incluidas las consultas federadas de Amazon Redshift Spectrum y Aurora PostgreSQL, la intercalación de la columna VARCHAR o CHAR es la misma que la intercalación actual en el nivel de base de datos.
En el siguiente ejemplo, se consulta una tabla de Amazon Redshift Spectrum:
```
SELECT ci_varchar FROM spectrum.test_collation
WHERE ci_varchar = 'AMAZON';
ci_varchar
----------
amazon
Amazon
AMAZON
AmaZon
(4 rows)
```
Para obtener información sobre cómo crear tablas mediante la intercalación de bases de datos, consulte [CREATE TABLE](r_CREATE_TABLE_NEW.md).
Para obtener información acerca de la función COLLATE, consulte [Función COLLATE](r_COLLATE.md).
### Limitaciones de la intercalación de bases de datos
A continuación, se describen las limitaciones que existen a la hora de trabajar con la intercalación de bases de datos en Amazon Redshift:
+ Todas las tablas o las vistas de sistema, incluidas las tablas del catálogo de PG y las tablas de sistema de Amazon Redshift, distinguen entre mayúsculas y minúsculas.
+ Cuando la base de datos consumidora y la base de datos productora tienen intercalaciones diferentes en el nivel de base de datos, Amazon Redshift no admite consultas entre bases de datos y clústeres.
+ Amazon Redshift no admite la intercalación sin distinción entre mayúsculas y minúsculas en la consulta del nodo principal específicamente.
En el siguiente ejemplo, se muestra una consulta no admitida que no distingue entre mayúsculas y minúsculas, además del error que envía Amazon Redshift:
```
SELECT collate(usename, 'case_insensitive') FROM pg_user;
ERROR: Case insensitive collation is not supported in leader node only query.
```
+ Amazon Redshift no admite la interacción entre columnas donde se distingue entre mayúsculas y minúsculas, y columnas donde no se hace esa distinción, como comparación, función, combinación u operaciones con conjuntos.
Los siguientes ejemplos muestran errores que ocurren cuando interactúan las columnas donde se distingue entre mayúsculas y minúsculas, y las columnas donde no se hace esa distinción:
```
CREATE TABLE test
(ci_col varchar(10) COLLATE case_insensitive,
cs_col varchar(10) COLLATE case_sensitive,
cint int,
cbigint bigint);
```
```
SELECT ci_col = cs_col FROM test;
ERROR: Query with different collations is not supported yet.
```
```
SELECT concat(ci_col, cs_col) FROM test;
ERROR: Query with different collations is not supported yet.
```
```
SELECT ci_col FROM test UNION SELECT cs_col FROM test;
ERROR: Query with different collations is not supported yet.
```
```
SELECT * FROM test a, test b WHERE a.ci_col = b.cs_col;
ERROR: Query with different collations is not supported yet.
```
```
Select Coalesce(ci_col, cs_col) from test;
ERROR: Query with different collations is not supported yet.
```
```
Select case when cint > 0 then ci_col else cs_col end from test;
ERROR: Query with different collations is not supported yet.
```
Para que estas consultas funcionen, utilice la función COLLATE para convertir la intercalación de una columna de manera que coincida con la otra. Para obtener más información, consulte [Función COLLATE](r_COLLATE.md).
## Ejemplos
**Creación de una base de datos**
En el siguiente ejemplo, se crea una base de datos llamada TICKIT y se concede la propiedad al usuario DWUSER.
```
create database tickit
with owner dwuser;
```
Consulte la tabla de catálogo PG\$1DATABASE\$1INFO para ver los detalles de las bases de datos.
```
select datname, datdba, datconnlimit
from pg_database_info
where datdba > 1;
datname | datdba | datconnlimit
-------------+--------+-------------
admin | 100 | UNLIMITED
reports | 100 | 100
tickit | 100 | 100
```
En el siguiente ejemplo se crea una base de datos denominada **sampledb** con nivel de aislamiento SNAPSHOT.
```
CREATE DATABASE sampledb ISOLATION LEVEL SNAPSHOT;
```
En el siguiente ejemplo, se crea la base de datos sales\$1db a partir del recurso compartido de datos SalesShare.
```
CREATE DATABASE sales_db FROM DATASHARE salesshare OF NAMESPACE '13b8833d-17c6-4f16-8fe4-1a018f5ed00d';
```
### Ejemplos de intercalación de bases de datos
**Creación de una base de datos donde no se distingue entre mayúsculas y minúsculas**
En el siguiente ejemplo, se crea la base de datos `sampledb`, se crea la tabla `T1` y se insertan datos en la tabla `T1`.
```
create database sampledb collate case_insensitive;
```
Conéctese a la nueva base de datos que acaba de crear mediante su cliente SQL. Cuando utilice el editor de consultas de Amazon Redshift v2, seleccione `sampledb` en el **Editor**. Cuando utiliza use RSQL, puede utilizar un comando como el siguiente.
```
\connect sampledb;
```
```
CREATE TABLE T1 (
col1 Varchar(20) distkey sortkey
);
```
```
INSERT INTO T1 VALUES ('bob'), ('john'), ('Mary'), ('JOHN'), ('Bob');
```
Luego, la consulta encuentra resultados con `John`.
```
SELECT * FROM T1 WHERE col1 = 'John';
col1
------
john
JOHN
(2 row)
```
**Ordenación sin distinción entre mayúsculas y minúsculas**
En el siguiente ejemplo, se muestra la ordenación sin distinción entre mayúsculas y minúsculas con la tabla T1. La ordenación de *Bob* y *bob* o de *John* y *john* no es determinista porque son iguales en la columna donde no se distingue entre mayúsculas y minúsculas.
```
SELECT * FROM T1 ORDER BY 1;
col1
------
bob
Bob
JOHN
john
Mary
(5 rows)
```
Del mismo modo, el siguiente ejemplo muestra cómo se ordena sin distinción entre mayúsculas y minúsculas con la cláusula GROUP BY. *Bob* y *bob* son iguales y pertenecen al mismo grupo. No es determinístico cuál aparece en el resultado.
```
SELECT col1, count(*) FROM T1 GROUP BY 1;
col1 | count
-----+------
Mary | 1
bob | 2
JOHN | 2
(3 rows)
```
**Consulta con una función de ventana en columnas donde no se distingue entre mayúsculas y minúsculas**
En el siguiente ejemplo, se consulta una función de ventana en una columna donde no se distingue entre mayúsculas y minúsculas.
```
SELECT col1, rank() over (ORDER BY col1) FROM T1;
col1 | rank
-----+------
bob | 1
Bob | 1
john | 3
JOHN | 3
Mary | 5
(5 rows)
```
**Consulta con la palabra clave DISTINCT**
En el siguiente ejemplo, se consulta la tabla `T1` con la palabra clave DISTINCT.
```
SELECT DISTINCT col1 FROM T1;
col1
------
bob
Mary
john
(3 rows)
```
**Consulta con la cláusula UNION**
En el siguiente ejemplo, se muestran los resultados de la cláusula UNION de las tablas `T1` y `T2`.
```
CREATE TABLE T2 AS SELECT * FROM T1;
```
```
SELECT col1 FROM T1 UNION SELECT col1 FROM T2;
col1
------
john
bob
Mary
(3 rows)
```
# CREATE DATASHARE
Cree un datashare nuevo en la base de datos actual. El propietario de este datashare es el emisor del comando CREATE DATASHARE.
Amazon Redshift asocia cada datashare a una sola base de datos de Amazon Redshift. Solo puede agregar objetos de la base de datos asociada a un datashare. Puede crear varios datashares en la misma base de datos de Amazon Redshift.
Para obtener más información sobre los recursos compartidos de datos, consulte [Uso compartido de datos en Amazon Redshift](datashare-overview.md).
Para ver información sobre los datashares, utilice [SHOW DATASHARES](r_SHOW_DATASHARES.md).
## Privilegios necesarios
Los siguientes privilegios son necesarios para CREATE DATASHARE:
+ Superusuario
+ Usuarios con el privilegio CREATE DATASHARE
+ Propietario de la base de datos
## Sintaxis
```
CREATE DATASHARE datashare_name
[[SET] PUBLICACCESSIBLE [=] TRUE | FALSE ];
```
## Parameters
*datashare\$1name*
El nombre del datashare. El nombre del datashare debe ser único en el espacio de nombres del clúster.
[[SET] PUBLICACCESSIBLE]
Se trata de una cláusula que especifica si el datashare se puede compartir con clústeres accesibles de manera pública.
El valor predeterminado de `SET PUBLICACCESSIBLE` es `FALSE`.
## Notas de uso
De manera predeterminada, el propietario del recurso compartido de datos solo posee el recurso compartido pero no los objetos dentro de este.
Solo los superusuarios y el propietario de la base de datos pueden utilizar CREATE DATASHARE y delegar privilegios ALTER a otros usuarios o grupos.
## Ejemplos
En el siguiente ejemplo, se crea el recurso compartido de datos de `salesshare`.
```
CREATE DATASHARE salesshare;
```
En el siguiente ejemplo, se crea el recurso compartido de datos de `demoshare` que administra AWS Data Exchange.
```
CREATE DATASHARE demoshare SET PUBLICACCESSIBLE TRUE, MANAGEDBY ADX;
```
# CREATE EXTERNAL FUNCTION
Crea una función definida por el usuario (UDF) escalar basada en AWS Lambda para Amazon Redshift. Para obtener más información acerca de las funciones de Lambda definidas por el usuario, consulte [UDF de Lambda escalares](udf-creating-a-lambda-sql-udf.md).
## Privilegios necesarios
Los siguientes privilegios son necesarios para CREATE EXTERNAL FUNCTION:
+ Superusuario
+ Usuarios con el privilegio CREATE [ OR REPLACE ] EXTERNAL FUNCTION
## Sintaxis
```
CREATE [ OR REPLACE ] EXTERNAL FUNCTION external_fn_name ( [data_type] [, ...] )
RETURNS data_type
{ VOLATILE | STABLE }
LAMBDA 'lambda_fn_name'
IAM_ROLE { default | ‘arn:aws:iam:::role/’
RETRY_TIMEOUT milliseconds
MAX_BATCH_ROWS count
MAX_BATCH_SIZE size [ KB | MB ];
```
## Parameters
OR REPLACE
Se trata de una cláusula que especifica que, si ya existe una función con el mismo nombre y los mismos tipos de datos de argumento de entrada o *firma* que este, debe reemplazarse la función existente. Solo puede reemplazar una función con una nueva función que defina un conjunto idéntico de tipos de datos. Debe ser un superusuario para reemplazar una función.
Si define una función con el mismo nombre que una función existente, pero con una firma diferente, crea una nueva función. En otras palabras, se sobrecarga el nombre de la función. Para obtener más información, consulte [Sobrecarga de los nombres de función](udf-naming-udfs.md#udf-naming-overloading-function-names).
*external\$1fn\$1name*
Se trata del nombre de la función externa. Si especifica un nombre de esquema (como myschema.myfunction), la función se crea con el esquema especificado. De lo contrario, la función se crea en el esquema actual. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
Recomendamos que utilice el prefijo en los nombres de todas las UDF `f_`. Amazon Redshift reserva el prefijo `f_` para los nombres de las UDF. Con el uso del prefijo `f_`, se asegura de que los nombres de las UDF no entren en conflicto con ninguno de los nombres de las funciones SQL integradas para Amazon Redshift ahora o en el futuro. Para obtener más información, consulte [Prevención de conflictos al dar nombre a las UDF](udf-naming-udfs.md).
*data\$1type*
Se trata del tipo de datos para los argumentos de entrada. Para obtener más información, consulte [UDF de Python escalares](udf-creating-a-scalar-udf.md) y [UDF de Lambda escalares](udf-creating-a-lambda-sql-udf.md).
RETURNS *data\$1type*
El tipo de datos del valor que la función devuelve. El tipo de datos RETURNS puede ser cualquier tipo de datos estándar de Amazon Redshift. Para obtener más información, consulte [UDF de Python escalares](udf-creating-a-scalar-udf.md) y [UDF de Lambda escalares](udf-creating-a-lambda-sql-udf.md).
VOLATILE \$1 STABLE
Informa al optimizador de consultas acerca de la volatilidad de la función.
Para obtener la mejor optimización, etiquete la función con la categoría de volatilidad válida más estricta. Las categorías de volatilidad, de la menos estricta a la más estricta, son las siguientes:
+ VOLATILE
+ STABLE
VOLATILE
Dados los mismos argumentos, la función puede devolver resultados diferentes en ejecuciones consecutivas, incluso para las filas de una única instrucción. El optimizador de consultas no puede hacer suposiciones sobre el comportamiento de una función volátil. Una consulta que utiliza una función volátil debe reevaluar la función para cada entrada.
STABLE
Dados los mismos argumentos, se garantiza que la función devuelve los mismos resultados en sucesivas llamadas procesadas en una misma instrucción. La función puede devolver resultados diferentes cuando se evoca en diferentes instrucciones. Con esta categoría, el optimizador puede reducir el número de veces que se llama a la función en una misma instrucción.
Tenga en cuenta que si el rigor elegido no es válido para la función, existe el riesgo de que el optimizador omita algunas llamadas basándose en este rigor. Esto puede provocar un conjunto de resultados incorrecto.
La cláusula IMMUTABLE no es compatible actualmente con las UDF de Lambda.
LAMBDA *'lambda\$1fn\$1name'*
Se trata del nombre de la función a la que llama Amazon Redshift.
Si desea conocer los pasos necesarios para crear una función de AWS Lambda, consulte [Creación de una función de Lambda con la consola](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html) en la *Guía para desarrolladores de AWS Lambda*.
Para obtener información acerca de los permisos necesarios para la función de Lambda, consulte [Permisos de AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-permissions.html) en la *Guía para desarrolladores de AWS Lambda*.
IAM\$1ROLE \$1 default \$1 ‘arn:aws:iam::**:role/**’
Utilice la palabra clave predeterminada para que Amazon Redshift utilice el rol de IAM configurado como predeterminado y asociado al clúster cuando se ejecuta el comando CREATE EXTERNAL FUNCTION.
Utilice el nombre de recurso de Amazon (ARN), de un rol de IAM que el clúster utiliza para la autenticación y la autorización. El comando CREATE EXTERNAL FUNCTION tiene autorización para invocar funciones de Lambda a través de este rol de IAM. Si su clúster tiene un rol de IAM existente con permisos para invocar funciones de Lambda adjuntas, puede sustituir el ARN de su rol. Para obtener más información, consulte [Configuración del parámetro de autorización para las UDF de Lambda](udf-creating-a-lambda-sql-udf.md#udf-lambda-authorization).
A continuación, se muestra la sintaxis del parámetro IAM\$1ROLE.
```
IAM_ROLE 'arn:aws:iam::aws-account-id:role/role-name'
```
RETRY\$1TIMEOUT *milliseconds*
Se trata de la cantidad de tiempo total en milisegundos que Amazon Redshift utiliza para los retrasos en el reintento de retroceso.
En lugar de volver a intentar ejecutar inmediatamente cualquier consulta que presente error, Amazon Redshift realiza retrocesos y espera cierta cantidad de tiempo entre reintentos. Luego, Amazon Redshift vuelve a intentar realizar la solicitud para ejecutar la consulta que presenta error de nuevo hasta que la suma de todos los retrasos sea igual o superior al valor RETRY\$1TIMEOUT que especificó. El valor predeterminado es 20 000 milisegundos.
Cuando se invoca una función de Lambda, Amazon Redshift vuelve a intentar ejecutar las consultas que presentan errores, como `TooManyRequestsException`, `EC2ThrottledException` y `ServiceException`.
Puede configurar el parámetro RETRY\$1TIMEOUT en 0 milisegundos para evitar cualquier reintento de ejecución de una UDF de Lambda.
MAX\$1BATCH\$1ROWS *recuento*
El número máximo de filas que Amazon Redshift envía en una sola solicitud por lotes para una única invocación de lambda.
El valor mínimo de este parámetro es 1. El valor máximo es INT\$1MAX o 2 147 483 647.
Este parámetro es opcional. El valor predeterminado es INT\$1MAX o 2 147 483 647.
MAX\$1BATCH\$1SIZE *tamaño* [ KB \$1 MB ]
El tamaño máximo de la carga útil de datos que Amazon Redshift envía en una sola solicitud por lotes para una única invocación de lambda.
El valor mínimo de este parámetro es 1 KB. El valor máximo es 5 MB.
El valor predeterminado de este parámetro es 5 MB.
KB y MB son opcionales. Si no establece la unidad de medida, Amazon Redshift utilizará KB de forma predeterminada.
## Notas de uso
Tenga en cuenta lo siguiente al crear UDF de Lambda:
+ El orden de las llamadas a la función de Lambda en los argumentos de entrada no es fijo ni está garantizado. Puede variar de una instancia a otra de las consultas en ejecución, en función de la configuración del clúster.
+ No se garantiza que las funciones se apliquen a cada argumento de entrada una vez y solo una vez. La interacción entre Amazon Redshift y AWS Lambda podría dar lugar a llamadas repetitivas con las mismas entradas.
## Ejemplos
A continuación, se proporcionan ejemplos de uso de funciones escalares de Lambda definidas por el usuario (UDF).
### Ejemplo de UDF escalar de Lambda con una función Node.js de Lambda
En el siguiente ejemplo, se crea una función externa denominada `exfunc_sum` que toma dos valores enteros como argumentos de entrada. Esta función devuelve la suma como una salida expresada con un número entero. El nombre de la función de Lambda a la que se llamará es `lambda_sum`. El lenguaje utilizado para esta función de Lambda es Node.js 12.x. Asegúrese de especificar el rol de IAM. El ejemplo utiliza `'arn:aws:iam::123456789012:user/johndoe'` como rol de IAM.
```
CREATE EXTERNAL FUNCTION exfunc_sum(INT,INT)
RETURNS INT
VOLATILE
LAMBDA 'lambda_sum'
IAM_ROLE 'arn:aws:iam::123456789012:role/Redshift-Exfunc-Test';
```
La función de Lambda toma la carga de solicitudes e itera sobre cada fila. Se suman todos los valores de una sola fila para calcular la suma de esa fila, que se guarda en la matriz de respuesta. La cantidad de filas en la matriz de resultados es similar a la cantidad de filas recibidas en la carga de la solicitud.
La carga de respuesta JSON debe tener los datos de resultado en el campo “results” para que la función externa la reconozca. El campo de argumentos de la solicitud enviada a la función de Lambda contiene la carga de datos. En el caso de una solicitud por lote, es posible que existan varias filas en la carga de datos. La siguiente función de Lambda itera sobre todas las filas de la carga de datos de la solicitud. También itera de forma individual sobre todos los valores dentro de una sola fila.
```
exports.handler = async (event) => {
// The 'arguments' field in the request sent to the Lambda function contains the data payload.
var t1 = event['arguments'];
// 'len(t1)' represents the number of rows in the request payload.
// The number of results in the response payload should be the same as the number of rows received.
const resp = new Array(t1.length);
// Iterating over all the rows in the request payload.
for (const [i, x] of t1.entries())
{
var sum = 0;
// Iterating over all the values in a single row.
for (const y of x) {
sum = sum + y;
}
resp[i] = sum;
}
// The 'results' field should contain the results of the lambda call.
const response = {
results: resp
};
return JSON.stringify(response);
};
```
En el siguiente ejemplo, se llama a la función externa con valores literales.
```
select exfunc_sum(1,2);
exfunc_sum
------------
3
(1 row)
```
En el siguiente ejemplo, se crea una tabla denominada t\$1sum con dos columnas, c1 y c2, del tipo de datos entero y se insertan dos filas de datos. Luego, se llama a la función externa transmitiendo los nombres de las columnas de esta tabla. Las dos filas de la tabla se envían en una solicitud por lote en la carga de la solicitud como una sola invocación de Lambda.
```
CREATE TABLE t_sum(c1 int, c2 int);
INSERT INTO t_sum VALUES (4,5), (6,7);
SELECT exfunc_sum(c1,c2) FROM t_sum;
exfunc_sum
---------------
9
13
(2 rows)
```
### Ejemplo de UDF escalar de Lambda con el atributo RETRY\$1TIMEOUT
En la siguiente sección, encontrará un ejemplo de cómo utilizar el atributo RETRY\$1TIMEOUT en las UDF de Lambda.
AWS LambdaLas funciones de tienen límites de simultaneidad que se pueden establecer para cada función. Para obtener más información acerca de los límites de simultaneidad, consulte [Administración de la simultaneidad para una función de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/configuration-concurrency.html) en la *Guía para desarrolladores de AWS Lambda* y la publicación [Administración de la simultaneidad de la función de AWS Lambda](https://aws.amazon.com/blogs/compute/managing-aws-lambda-function-concurrency) en el blog de computación de AWS.
Cuando la cantidad de solicitudes que atiende una UDF de Lambda supera los límites de simultaneidad, las solicitudes nuevas reciben el error `TooManyRequestsException`. La UDF de Lambda intenta solucionar este error de nuevo hasta que la suma de todos los retrasos entre las solicitudes enviadas a la función de Lambda sea igual o superior al valor RETRY\$1TIMEOUT que estableció. El valor predeterminado de RETRY\$1TIMEOUT es 20 000 milisegundos.
En el siguiente ejemplo, se utiliza una función de Lambda denominada `exfunc_sleep_3`. Esta función toma la carga de la solicitud, itera sobre cada fila y convierte la entrada a mayúsculas. Luego, está inactiva durante 3 segundos y devuelve el resultado. El lenguaje utilizado para esta función de Lambda es Python 3.8.
La cantidad de filas en la matriz de resultados es similar a la cantidad de filas recibidas en la carga de la solicitud. La carga de respuesta JSON debe tener los datos de resultado en el campo `results` para que la función externa la reconozca. El campo de `arguments` de la solicitud enviada a la función de Lambda contiene la carga de datos. En el caso de una solicitud por lote, es posible que aparezcan varias filas en la carga de datos.
El límite de simultaneidad para esta función se configura específicamente en 1 en simultaneidad reservada para demostrar el uso del atributo RETRY\$1TIMEOUT. Cuando el atributo se configura en 1, la función de Lambda solo puede atender una solicitud a la vez.
```
import json
import time
def lambda_handler(event, context):
t1 = event['arguments']
# 'len(t1)' represents the number of rows in the request payload.
# The number of results in the response payload should be the same as the number of rows received.
resp = [None]*len(t1)
# Iterating over all rows in the request payload.
for i, x in enumerate(t1):
# Iterating over all the values in a single row.
for j, y in enumerate(x):
resp[i] = y.upper()
time.sleep(3)
ret = dict()
ret['results'] = resp
ret_json = json.dumps(ret)
return ret_json
```
A continuación, se incluyen dos ejemplos adicionales que ilustran el atributo RETRY\$1TIMEOUT. Cada ejemplo invoca una sola UDF de Lambda. Cuando invocan la UDF de Lambda, cada ejemplo ejecuta la misma consulta SQL para invocar la UDF de Lambda desde dos sesiones de base de datos simultáneas. Cuando la primera consulta que invoca la UDF de Lambda es atendida por la UDF, la segunda consulta recibe el error `TooManyRequestsException`. Este resultado se produce porque se configura de forma específica la simultaneidad reservada en 1 en la UDF. Para obtener información sobre cómo establecer la simultaneidad reservada para las funciones de Lambda, consulte [Configuración de la simultaneidad reservada](https://docs.aws.amazon.com/lambda/latest/dg/configuration-concurrency.html#configuration-concurrency-reservedconfiguration-concurrency-reserved).
A continuación, el primer ejemplo configura el atributo RETRY\$1TIMEOUT para la UDF de Lambda en 0 milisegundos. Si la solicitud de Lambda recibe alguna excepción de la función de Lambda, Amazon Redshift no realiza ningún reintento. Este resultado se produce porque el atributo RETRY\$1TIMEOUT se configura en 0.
```
CREATE OR REPLACE EXTERNAL FUNCTION exfunc_upper(varchar)
RETURNS varchar
VOLATILE
LAMBDA 'exfunc_sleep_3'
IAM_ROLE 'arn:aws:iam::123456789012:role/Redshift-Exfunc-Test'
RETRY_TIMEOUT 0;
```
Con RETRY\$1TIMEOUT configurado en 0, puede ejecutar las siguientes dos consultas desde sesiones de base de datos independientes para ver resultados diferentes.
La primera consulta SQL que utiliza la UDF de Lambda se ejecuta correctamente.
```
select exfunc_upper('Varchar');
exfunc_upper
--------------
VARCHAR
(1 row)
```
La segunda consulta, que se ejecuta desde una sesión de base de datos independiente al mismo tiempo, recibe el error `TooManyRequestsException`.
```
select exfunc_upper('Varchar');
ERROR: Rate Exceeded.; Exception: TooManyRequestsException; ShouldRetry: 1
DETAIL:
-----------------------------------------------
error: Rate Exceeded.; Exception: TooManyRequestsException; ShouldRetry: 1
code: 32103
context:query: 0
location: exfunc_client.cpp:102
process: padbmaster [pid=26384]
-----------------------------------------------
```
A continuación, el segundo ejemplo configura el atributo RETRY\$1TIMEOUT para la UDF de Lambda en 3000 milisegundos. Incluso si la segunda consulta se ejecuta de forma simultánea, la UDF de Lambda reintenta la ejecución hasta que el retraso total sea de 3000 milisegundos. Por lo tanto, ambas consultas se ejecutan correctamente.
```
CREATE OR REPLACE EXTERNAL FUNCTION exfunc_upper(varchar)
RETURNS varchar
VOLATILE
LAMBDA 'exfunc_sleep_3'
IAM_ROLE 'arn:aws:iam::123456789012:role/Redshift-Exfunc-Test'
RETRY_TIMEOUT 3000;
```
Con RETRY\$1TIMEOUT configurado en 3000, puede ejecutar las siguientes dos consultas desde sesiones de base de datos independientes para ver los mismos resultados.
La primera consulta SQL que ejecuta la UDF de Lambda se ejecuta correctamente.
```
select exfunc_upper('Varchar');
exfunc_upper
--------------
VARCHAR
(1 row)
```
La segunda consulta se ejecuta de forma simultánea, y la UDF de Lambda reintenta la ejecución hasta que el retraso total sea de 3000 milisegundos.
```
select exfunc_upper('Varchar');
exfunc_upper
--------------
VARCHAR
(1 row)
```
### Ejemplo de UDF escalar de Lambda con una función Python de Lambda
En el siguiente ejemplo, se crea una función externa denominada `exfunc_multiplication` que multiplica números y devuelve un número entero. Este ejemplo incorpora los campos de éxito y `error_msg` en la respuesta de Lambda. El campo de éxito se establece como false cuando hay un desbordamiento de valores enteros en el resultado de la multiplicación y el mensaje `error_msg` se establece como `Integer multiplication overflow`. La función `exfunc_multiplication` toma tres valores enteros como argumentos de entrada y devuelve la suma como un valor de salida entero.
El nombre de la función de Lambda que se llama es `lambda_multiplication`. El lenguaje utilizado para esta función de Lambda es Python 3.8. Asegúrese de especificar el rol de IAM.
```
CREATE EXTERNAL FUNCTION exfunc_multiplication(int, int, int)
RETURNS INT
VOLATILE
LAMBDA 'lambda_multiplication'
IAM_ROLE 'arn:aws:iam::123456789012:role/Redshift-Exfunc-Test';
```
La función de Lambda toma la carga de solicitudes e itera sobre cada fila. Todos los valores de una sola fila se multiplican para calcular el resultado de esa fila, que se guarda en la lista de respuestas. En este ejemplo, se utiliza un valor booleano de éxito establecido como true de manera predeterminada. Si el resultado de la multiplicación de una fila tiene un desbordamiento de valores enteros, el valor de éxito se establece como false. Por lo tanto, se interrumpe el ciclo de iteraciones.
Durante la creación de la carga de respuesta, si el valor de éxito es false, la siguiente función de Lambda agrega el campo `error_msg` a la carga. También establece el mensaje de error en `Integer multiplication overflow`. Si el valor de éxito es true, los datos de resultado se agregan en el campo de resultados. La cantidad de filas en la matriz de resultados, si hay, es similar a la cantidad de filas recibidas en la carga de la solicitud.
El campo de argumentos de la solicitud enviada a la función de Lambda contiene la carga de datos. En el caso de una solicitud por lote, es posible que existan varias filas en la carga de datos. La siguiente función de Lambda itera sobre todas las filas de la carga de datos de la solicitud e itera de manera individual sobre todos los valores dentro de una sola fila.
```
import json
def lambda_handler(event, context):
t1 = event['arguments']
# 'len(t1)' represents the number of rows in the request payload.
# The number of results in the response payload should be the same as the number of rows received.
resp = [None]*len(t1)
# By default success is set to 'True'.
success = True
# Iterating over all rows in the request payload.
for i, x in enumerate(t1):
mul = 1
# Iterating over all the values in a single row.
for j, y in enumerate(x):
mul = mul*y
# Check integer overflow.
if (mul >= 9223372036854775807 or mul <= -9223372036854775808):
success = False
break
else:
resp[i] = mul
ret = dict()
ret['success'] = success
if not success:
ret['error_msg'] = "Integer multiplication overflow"
else:
ret['results'] = resp
ret_json = json.dumps(ret)
return ret_json
```
En el siguiente ejemplo, se llama a la función externa con valores literales.
```
SELECT exfunc_multiplication(8, 9, 2);
exfunc_multiplication
---------------------------
144
(1 row)
```
En el siguiente ejemplo, se crea una tabla denominada t\$1multi con tres columnas, c1, c2 y c3, del tipo de datos entero. Se llama a la función externa transmitiendo los nombres de las columnas de esta tabla. Los datos se insertan de tal manera que provocan un desbordamiento de valores enteros para mostrar cómo se propaga el error.
```
CREATE TABLE t_multi (c1 int, c2 int, c3 int);
INSERT INTO t_multi VALUES (2147483647, 2147483647, 4);
SELECT exfunc_multiplication(c1, c2, c3) FROM t_multi;
DETAIL:
-----------------------------------------------
error: Integer multiplication overflow
code: 32004context:
context:
query: 38
location: exfunc_data.cpp:276
process: query2_16_38 [pid=30494]
-----------------------------------------------
```
# CREATE EXTERNAL MODEL
**Topics**
+ [Requisitos previos para CREATE EXTERNAL MODEL](#r_create_external_model_prereqs)
+ [Privilegios necesarios](#r_simple_create_model-privileges)
+ [Control de costes](#r_create_model_cost)
+ [Sintaxis de CREATE EXTERNAL MODEL](#r_create_external_model_syntax)
+ [Parámetros y configuración de CREATE EXTERNAL MODEL](#r_create_external_model_parameters_settings)
+ [Parámetros de función de inferencia de CREATE EXTERNAL MODEL](#r_create_external_model_if_parameters)
## Requisitos previos para CREATE EXTERNAL MODEL
Antes de utilizar la instrucción CREATE EXTERNAL MODEL, complete los requisitos previos en [Configuración del clúster para utilizar Amazon Redshift ML](getting-started-machine-learning.md#cluster-setup). A continuación, se brinda un resumen de alto nivel de los requisitos previos.
+ Cree un clúster de Amazon Redshift con la consola de administración de AWS o la AWS Command Line Interface (AWS CLI)
+ Adjunte la política de AWS Identity and Access Management (IAM) mientras crea el clúster.
+ Para permitir que Amazon Redshift y Amazon Bedrock asuman el rol a la hora de interactuar con otros servicios, agregue la política de confianza adecuada al rol de IAM.
+ Habilite el acceso a los LLM específicos que desee usar desde la consola de Amazon Bedrock.
+ (Opcional) Si encuentra excepciones que imponen limitaciones provenientes de Amazon Bedrock, por ejemplo, `Too many requests, please wait before trying again`, incluso con pequeñas cantidades de datos, compruebe las cuotas en **Service Quotas** en su cuenta de Amazon Bedrock. Compruebe que la cuota de cuenta aplicada sea como mínimo igual al valor de la cuota predeterminada de AWS para las solicitudes de **InvokeModel** para el modelo que está utilizando.
Para obtener detalles sobre el rol de IAM, la política de confianza y otros requisitos previos, consulte [Configuración del clúster para utilizar Amazon Redshift ML](getting-started-machine-learning.md#cluster-setup).
## Privilegios necesarios
Los siguientes privilegios son necesarios para CREATE EXTERNAL MODEL:
+ Superusuario
+ Usuarios con el privilegio CREATE MODEL
+ Roles con el privilegio GRANT CREATE MODEL
## Control de costes
Amazon Redshift ML utiliza los recursos de clúster existentes para crear modelos de predicción, por lo que no es necesario pagar costes adicionales. Sin embargo, los cargos de AWS por el uso de Amazon Bedrock dependen del modelo que seleccione. Para obtener más información, consulte [Costes para usar Amazon Redshift ML](https://docs.aws.amazon.com/redshift/latest/dg/cost.html).
## Sintaxis de CREATE EXTERNAL MODEL
A continuación, se muestra la sintaxis completa de la instrucción CREATE EXTERNAL MODEL.
```
CREATE EXTERNAL MODEL model_name
FUNCTION function_name
IAM_ROLE {default/'arn:aws:iam:::role/'}
MODEL_TYPE BEDROCK
SETTINGS (
MODEL_ID model_id
[, PROMPT 'prompt prefix']
[, SUFFIX 'prompt suffix']
[, REQUEST_TYPE {RAW|UNIFIED}]
[, RESPONSE_TYPE {VARCHAR|SUPER}]
);
```
El comando `CREATE EXTERNAL MODEL` crea una función de inferencia que se utiliza para generar contenido.
A continuación, se muestra la sintaxis de una función de inferencia que `CREATE EXTERNAL MODEL` crea mediante un `REQUEST_TYPE` de `RAW`:
```
SELECT inference_function_name(request_super)
[FROM table];
```
A continuación, se muestra la sintaxis de una función de inferencia que `CREATE EXTERNAL MODEL` crea mediante un `REQUEST_TYPE` de `UNIFIED`:
```
SELECT inference_function_name(input_text, [, inference_config [, additional_model_request_fields]])
[FROM table];
```
Para obtener información sobre cómo usar la función de inferencia, consulte [Uso de un modelo externo para la integración de Amazon Redshift ML con Amazon Bedrock](machine-learning-br.md#machine-learning-br-use).
## Parámetros y configuración de CREATE EXTERNAL MODEL
En esta sección se describen los parámetros y la configuración del comando `CREATE EXTERNAL MODEL`.
**Topics**
+ [Parámetros de CREATE EXTERNAL MODEL](#r_create_external_model_parameters)
+ [Configuración de CREATE EXTERNAL MODEL](#r_create_external_model_settings)
### Parámetros de CREATE EXTERNAL MODEL
model\$1name
El nombre del modelo externo. El nombre del modelo en un esquema debe ser único.
FUNCTION *function\$1name (data\$1type [,...] )*
El nombre de la función de inferencia que `CREATE EXTERNAL MODEL` crea. La función de inferencia se utiliza para enviar solicitudes a Amazon Bedrock y recuperar el texto generado por ML.
IAM\$1ROLE * \$1 default \$1 'arn:aws:iam:::role/' \$1*
El rol de IAM que Amazon Redshift utiliza para acceder a Amazon Bedrock. Para obtener información acerca del rol de IAM, consulte [Creación o actualización de un rol de IAM para la integración de Amazon Redshift ML con Amazon Bedrock](machine-learning-br.md#machine-learning-br-iam).
MODEL\$1TYPE BEDROCK
Especifica el tipo de modelo. El único valor válido es `BEDROCK`.
SETTINGS ( MODEL\$1ID model\$1id [,...] )
Especifica la configuración del modelo externo. Consulte la siguiente sección para obtener más información.
### Configuración de CREATE EXTERNAL MODEL
MODEL\$1ID model\$1id
El identificador del modelo externo, por ejemplo, `anthropic.claude-v2`. Para obtener información sobre los ID de modelo de Amazon Bedrock, consulte [Amazon Bedrock model IDs](https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html).
PROMPT “prefijo de petición”
Especifica una petición estática que Amazon Redshift agrega al principio de cada solicitud de inferencia. Solo se admite con un `REQUEST_TYPE` de `UNIFIED`.
SUFFIX “sufijo de petición”
Especifica una petición estática que Amazon Redshift agrega al final de cada solicitud de inferencia. Solo se admite con un `REQUEST_TYPE` de `UNIFIED`.
REQUEST\$1TYPE \$1 RAW \$1 UNIFIED \$1
Especifica el formato de la solicitud enviada a Amazon Bedrock. Entre los valores válidos se incluyen los siguientes:
+ **RAW**: la función de inferencia toma la entrada como un supervalor único y siempre devuelve un supervalor. El formato del supervalor es específico del modelo de Amazon Bedrock seleccionado. Un súper es un modelo de predicción que combina varios algoritmos para producir una única predicción mejorada.
+ **UNIFIED**: la función de inferencia utiliza la API unificada. Todos los modelos tienen una interfaz unificada y coherente con Amazon Bedrock. Esto funciona para todos los modelos que admiten mensajes. Este valor es el valor predeterminado.
Para obtener más información, consulte la [Documentación de la API de conversión](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) en la *Documentación de la API de Amazon Bedrock*.
RESPONSE\$1TYPE \$1 VARCHAR \$1 SUPER \$1
Especifica el formato de la respuesta. Si `REQUEST_TYPE` es `RAW`, `RESPONSE_TYPE` es obligatorio y el único valor válido es `SUPER`. Para todos los demás valores `REQUEST TYPE`, el valor predeterminado es `VARCHAR` y `RESPONSE_TYPE` es opcional. Entre los valores válidos se incluyen los siguientes:
+ **VARCHAR**: Amazon Redshift solo devuelve la respuesta de texto generada por el modelo.
+ **SUPER**: Amazon Redshift devuelve todo el JSON de respuesta generado por el modelo en forma de súper. Esto incluye la respuesta de texto e información como el motivo de la parada y el uso de los tokens de entrada y salida del modelo. Un súper es un modelo de predicción que combina varios algoritmos para producir una única predicción mejorada.
## Parámetros de función de inferencia de CREATE EXTERNAL MODEL
En esta sección se describen los parámetros válidos para la función de inferencia que crea el comando `CREATE EXTERNAL MODEL`.
### Parámetros de función de inferencia de CREATE EXTERNAL MODEL para `REQUEST_TYPE` de `RAW`
Una función de inferencia creada con un `REQUEST_TYPE` de `RAW` tiene un argumento de superentrada y siempre devuelve un tipo de superdatos. La sintaxis de la superentrada sigue la sintaxis de la solicitud del modelo específico seleccionado de Amazon Bedrock.
### Parámetros de función de inferencia de CREATE EXTERNAL MODEL para `REQUEST_TYPE` de `UNIFIED`
input\$1text
El texto que Amazon Redshift envía a Amazon Bedrock.
inference\$1config
Un supervalor que contiene parámetros opcionales que Amazon Redshift envía a Amazon Bedrock. Estos pueden incluir los siguientes:
+ maxTokens
+ stopSequences
+ temperature
+ topP
Todos estos parámetros son opcionales y distinguen entre mayúsculas y minúsculas. Para obtener información sobre estos parámetros, consulte [InferenceConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InferenceConfiguration.html) en la *referencia de la API de Amazon Bedrock*.
# CREATE EXTERNAL SCHEMA
Crea un nuevo esquema externo en la base de datos actual. Puede utilizar este esquema externo para conectarse a las bases de datos de Amazon RDS for PostgreSQL o la Edición compatible con PostgreSQL de Amazon Aurora. También puede crear un esquema externo que referencie una base de datos en un catálogo de datos externo, como AWS Glue, Athena o una base de datos en un metastore de Apache Hive, como Amazon EMR.
El propietario de este esquema es el emisor del comando CREATE EXTERNAL SCHEMA. Para transferir la propiedad de un esquema externo, use [ALTER SCHEMA](r_ALTER_SCHEMA.md) para cambiar el propietario. Para conceder acceso al esquema a otros usuarios o grupos utilice el comando [GRANT](r_GRANT.md).
No puede usar los comandos GRANT o REVOKE para los permisos en una tabla externa. En lugar de ello, conceda o revoque los permisos en el esquema externo.
**nota**
Si actualmente tiene tablas externas de Redshift Spectrum en el catálogo de datos de Amazon Athena, puede migrar el catálogo de datos de Athena a un AWS Glue Data Catalog. Para utilizar el catálogo de datos de AWS Glue con Redshift Spectrum, es posible que tenga que cambiar las políticas de AWS Identity and Access Management (IAM). Para obtener más información, consulte [Actualización al catálogo de datos de AWS Glue](https://docs.aws.amazon.com/athena/latest/ug/glue-athena.html#glue-upgrade) en la *Guía del usuario de Athena*.
Para ver detalles de los esquemas externos, consulte la vista del sistema [SVV\$1EXTERNAL\$1SCHEMAS](r_SVV_EXTERNAL_SCHEMAS.md).
## Sintaxis
La sintaxis siguiente describe el comando CREATE EXTERNAL SCHEMA utilizado para hacer referencia a datos mediante un catálogo de datos externo. Para obtener más información, consulte [Amazon Redshift Spectrum](c-using-spectrum.md).
```
CREATE EXTERNAL SCHEMA [IF NOT EXISTS] local_schema_name
FROM [ [ DATA CATALOG ] | HIVE METASTORE | POSTGRES | MYSQL | KINESIS | MSK | REDSHIFT | KAFKA ]
[ DATABASE 'database_name' ]
[ SCHEMA 'schema_name' ]
[ REGION 'aws-region' ]
[ IAM_ROLE [ default | 'SESSION' | 'arn:aws:iam:::role/' ] ]
[ AUTHENTICATION [ none | iam | mtls] ]
[ AUTHENTICATION_ARN 'acm-certificate-arn' | SECRET_ARN 'ssm-secret- arn' ]
[ URI ['hive_metastore_uri' [ PORT port_number ] | 'hostname' [ PORT port_number ] | 'Kafka bootstrap URL'] ]
[ CLUSTER_ARN 'arn:aws:kafka:::cluster/msk/' ]
[ CATALOG_ROLE [ 'SESSION' | 'catalog-role-arn-string' ] ]
[ CREATE EXTERNAL DATABASE IF NOT EXISTS ]
[ CATALOG_ID 'Amazon Web Services account ID containing Glue or Lake Formation database' ]
```
La siguiente sintaxis describe el comando CREATE EXTERNAL SCHEMA que se utiliza para referenciar datos mediante una consulta federada a RDS POSTGRES o Aurora PostgreSQL. También se puede crear un esquema externo que haga referencia a orígenes de streaming, como Kinesis Data Streams. Para obtener más información, consulte [Consulta de datos con consultas federadas en Amazon Redshift](federated-overview.md).
```
CREATE EXTERNAL SCHEMA [IF NOT EXISTS] local_schema_name
FROM POSTGRES
DATABASE 'federated_database_name' [SCHEMA 'schema_name']
URI 'hostname' [ PORT port_number ]
IAM_ROLE [ default | 'arn:aws:iam:::role/' ]
SECRET_ARN 'ssm-secret-arn'
```
La siguiente sintaxis describe el comando CREATE EXTERNAL SCHEMA que se utiliza para referenciar datos mediante una consulta federada a RDS MySQL o Aurora MySQL. Para obtener más información, consulte [Consulta de datos con consultas federadas en Amazon Redshift](federated-overview.md).
```
CREATE EXTERNAL SCHEMA [IF NOT EXISTS] local_schema_name
FROM MYSQL
DATABASE 'federated_database_name'
URI 'hostname' [ PORT port_number ]
IAM_ROLE [ default | 'arn:aws:iam:::role/' ]
SECRET_ARN 'ssm-secret-arn'
```
La siguiente sintaxis describe el comando CREATE EXTERNAL SCHEMA que se utiliza para hacer referencia a datos de un flujo de Kinesis. Para obtener más información, consulte [Ingesta de streaming a una vista materializada](materialized-view-streaming-ingestion.md).
```
CREATE EXTERNAL SCHEMA [IF NOT EXISTS] schema_name
FROM KINESIS
IAM_ROLE [ default | 'arn:aws:iam:::role/' ]
```
La siguiente sintaxis describe el comando CREATE EXTERNAL SCHEMA utilizado para hacer referencia al clúster de Amazon Managed Streaming para Apache Kafka o Confluent Cloud y los temas desde los cuales se incorpora. Para conectarse, debe proporcionar el URI del agente. Para obtener más información, consulte [Ingesta de streaming a una vista materializada](materialized-view-streaming-ingestion.md).
```
CREATE EXTERNAL SCHEMA [IF NOT EXISTS] schema_name
FROM KAFKA
[ IAM_ROLE [ default | 'arn:aws:iam:::role/' ] ]
URI 'Kafka bootstrap URI'
AUTHENTICATION [ none | iam | mtls ]
[ AUTHENTICATION_ARN 'acm-certificate-arn' | SECRET_ARN 'ssm-secret- arn' ];
```
La siguiente sintaxis describe el comando CREATE EXTERNAL SCHEMA que se utiliza para referenciar datos mediante una consulta entre distintas bases de datos.
```
CREATE EXTERNAL SCHEMA local_schema_name
FROM REDSHIFT
DATABASE 'redshift_database_name' SCHEMA 'redshift_schema_name'
```
## Parameters
IF NOT EXISTS
Una cláusula que indica que si el esquema especificado ya existe, el comando no debe realizar cambios y debe devolver un mensaje en el que se indique que el esquema existe, en lugar de terminar con un error. Esta cláusula es útil cuando se realiza scripting, para que el script no produzca un error si CREATE EXTERNAL SCHEMA intenta crear un esquema que ya existe.
nombre\$1de\$1esquema\$1local
El nombre del nuevo esquema externo. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
FROM [ DATA CATALOG ] \$1 HIVE METASTORE \$1 POSTGRES \$1 MYSQL \$1 KINESIS \$1 MSK \$1 REDSHIFT
Una palabra clave que indica dónde está ubicada la base de datos externa.
DATA CATALOG indica que la base de datos externa se define en el catálogo de datos de Athena o en el AWS Glue Data Catalog.
Si la base de datos externa se define en un catálogo de datos externo en una región de AWS diferente, el parámetro REGION es obligatorio. DATA CATALOG es el valor predeterminado.
HIVE METASTORE indica que la base de datos externa está definida en un metaalmacén Apache Hive. Si se especifica HIVE METASTORE, se requiere el URI.
POSTGRES indica que la base de datos externa está definida en RDS PostgreSQL o Aurora PostgreSQL.
MYSQL indica que la base de datos externa está definida en RDS MySQL o Aurora MySQL.
KINESIS indica que el origen de datos es un flujo de Kinesis Data Streams.
MSK indica que el origen de datos es un clúster aprovisionado o sin servidor de Amazon MSK.
KAFKA indica que el origen de datos es un clúster de Kafka. Puede utilizar esta palabra clave para Amazon MSK y Confluent Cloud.
FROM REDSHIFT
Se trata de una palabra clave que indica que la base de datos se encuentra en Amazon Redshift.
DATABASE '*redshift\$1database\$1name*' SCHEMA '*redshift\$1schema\$1name*'
Se trata del nombre de la base de datos de Amazon Redshift.
El parámetro *redshift\$1schema\$1name* indica el esquema en Amazon Redshift. El parámetro *redshift\$1schema\$1name* predeterminado es `public`.
DATABASE '*federated\$1database\$1name*'
Se trata de una palabra clave que indica el nombre de la base de datos externa en un motor de base de datos de PostgreSQL o MySQL compatible.
[SCHEMA '*schema\$1name*']
El parámetro *schema\$1name* indica el esquema en un motor de base de datos de PostgreSQL compatible. El valor predeterminado de *schema\$1name* es `public`.
No se puede especificar un SCHEMA cuando se configura una consulta federada a un motor de base de datos de MySQL compatible.
REGION '*aws-region*'
Si la base de datos externa se define en un catálogo de datos de Athena o en el AWS Glue Data Catalog, esta es la región de AWS en la que se encuentra la base de datos. Este parámetro es obligatorio si la base de datos se define en un catálogo de datos externo.
URI [ 'hive\$1metastore\$1uri' [ PORT port\$1number ] \$1 'hostname' [ PORT port\$1number ] \$1 'Kafka bootstrap URI' ]
Se trata del URI del nombre del alojamiento y el port\$1number de un motor de base de datos de PostgreSQL o MySQL compatible. El *hostname* es el nodo principal del conjunto de réplicas. El punto de conexión debe ser accesible (enrutable) desde el clúster de Amazon Redshift. El port\$1number predeterminado de PostgreSQL es 5432. El port\$1number predeterminado para MySQL es 3306.
El motor de base de datos de PostgreSQL o MySQL compatible debe estar en la misma VPC que el clúster de Amazon Redshift con un grupo de seguridad que vincule Amazon Redshift y RDS url-rsPostgreSQL o Aurora PostgreSQL. Además, puede usar el enrutamiento de VPC mejorado para configurar un caso de uso entre VPC. Para obtener más información, consulte [Puntos de conexión de VPC administrador por Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/managing-cluster-cross-vpc.html).
**Especificación de un URI de metastore de hive**
Si la base de datos está en un metaalmacén Hive, especifique el URI y, de manera opcional, el número de puerto para el metaalmacén. El número de puerto predeterminado es 9083.
Un URI no contiene una especificación de protocolo (“http://”). Un ejemplo de URI válido es .: `uri '172.10.10.10'`.
**Especificación de un URI de agente para la ingesta de streaming**
La inclusión del URI de bootstrap-broker proporciona la capacidad de conectarse a un clúster de Amazon MSK o Confluent Cloud y recibir datos transmitidos. Para obtener más información y ver un ejemplo, consulte [Introducción a la ingesta de streaming de Amazon Managed Streaming para Apache Kafka](https://docs.aws.amazon.com/redshift/latest/dg/materialized-view-streaming-ingestion-getting-started-MSK.html).
IAM\$1ROLE [ default \$1 'SESSION' \$1 'arn:aws:iam::**:role/**' ]
Utilice la palabra clave predeterminada para que Amazon Redshift utilice el rol de IAM configurado como predeterminado y asociado al clúster cuando se ejecuta el comando CREATE EXTERNAL SCHEMA.
Use `'SESSION'` si se conecta al clúster de Amazon Redshift mediante una identidad federada y acceda a las tablas desde el esquema externo creado con este comando. Para obtener más información, consulte [Uso de una identidad federada para administrar el acceso de Amazon Redshift a los recursos locales y a las tablas externas de Amazon Redshift Spectrum](https://docs.aws.amazon.com/redshift/latest/mgmt/authorization-fas-spectrum.html), lo que explica cómo configurar la identidad federada. Tenga en cuenta que esta configuración, con `'SESSION'` en lugar del ARN, solo se puede usar si el esquema se crea utilizando `DATA CATALOG`.
Utilice el nombre de recurso de Amazon (ARN), de un rol de IAM que el clúster utiliza para la autenticación y la autorización. Como mínimo, el rol de IAM debe tener permiso para realizar una operación LIST en el bucket de Amazon S3 al que se accederá y una operación GET en los objetos de Amazon S3 que el bucket contiene.
A continuación se muestra la sintaxis de la cadena del parámetro IAM\$1ROLE para un único ARN.
```
IAM_ROLE 'arn:aws:iam:::role/'
```
Puede encadenar roles para que el clúster pueda asumir otro rol de IAM, que posiblemente pertenezca a otra cuenta. Puede encadenar hasta 10 roles. Para ver un ejemplo de encadenamiento de roles, consulte [Encadenamiento de roles de IAM en Amazon Redshift Spectrum](c-spectrum-iam-policies.md#c-spectrum-chaining-roles).
Para este rol de IAM; asocie una política de permisos de IAM similar a la siguiente.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AccessSecret",
"Effect": "Allow",
"Action": [
"secretsmanager:GetResourcePolicy",
"secretsmanager:GetSecretValue",
"secretsmanager:DescribeSecret",
"secretsmanager:ListSecretVersionIds"
],
"Resource": "arn:aws:secretsmanager:us-west-2:123456789012:secret:my-rds-secret-VNenFy"
},
{
"Sid": "VisualEditor1",
"Effect": "Allow",
"Action": [
"secretsmanager:GetRandomPassword",
"secretsmanager:ListSecrets"
],
"Resource": "*"
}
]
}
```
Para obtener información sobre los pasos para crear un rol de IAM que se utilizará con la consulta federada, consulte [Creación de un secreto y rol de IAM para utilizar consultas federadas](federated-create-secret-iam-role.md).
No incluya espacios en la lista de roles encadenados.
A continuación se muestra la sintaxis para encadenar tres roles.
```
IAM_ROLE 'arn:aws:iam:::role/,arn:aws:iam:::role/,arn:aws:iam:::role/'
```
SECRET\$1ARN '*ssm-secret-arn*'
Se trata del nombre de recurso de Amazon (ARN) de un secreto de motor de base de datos de PostgreSQL o MySQL compatible creado mediante AWS Secrets Manager. Para obtener información sobre cómo crear y recuperar un ARN para un secreto, consulte [Administrar secretos con AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) en la *Guía del usuario de AWS Secrets Manager*, y [Recuperar el nombre de recurso de Amazon (ARN) del secreto en Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-secrets-manager-integration-retrieving-secret.html).
CATALOG\$1ROLE [ 'SESSION' \$1 *catalog-role-arn-string*]
Use `'SESSION'` para conectarse al clúster de Amazon Redshift mediante una identidad federada para la autenticación y la autorización del catálogo de datos. Para obtener más información acerca de completar los pasos para la identidad federada, consulte [Uso de una identidad federada para administrar el acceso de Amazon Redshift a los recursos locales y a las tablas externas de Amazon Redshift Spectrum](https://docs.aws.amazon.com/redshift/latest/mgmt/authorization-fas-spectrum.html). Tenga en cuenta que el rol `'SESSION'` solo se puede usar si el esquema se crea en el CATÁLOGO DE DATOS.
Utilice el nombre de recurso de Amazon (ARN), para un rol de IAM que el clúster utiliza para la autenticación y la autorización del catálogo de datos.
Si no se especifica CATALOG\$1ROLE, Amazon Redshift utiliza el IAM\$1ROLE especificado. El rol del catálogo debe tener permiso para acceder al catálogo de datos en AWS Glue o Athena. Para obtener más información, consulte [Políticas de IAM para Amazon Redshift Spectrum](c-spectrum-iam-policies.md).
A continuación se muestra la sintaxis de la cadena del parámetro CATALOG\$1ROLE para un único ARN.
```
CATALOG_ROLE 'arn:aws:iam:::role/'
```
Puede encadenar roles para que el clúster pueda asumir otro rol de IAM, que posiblemente pertenezca a otra cuenta. Puede encadenar hasta 10 roles. Para obtener más información, consulte [Encadenamiento de roles de IAM en Amazon Redshift Spectrum](c-spectrum-iam-policies.md#c-spectrum-chaining-roles).
La lista de roles encadenados no debe incluir espacios.
A continuación se muestra la sintaxis para encadenar tres roles.
```
CATALOG_ROLE 'arn:aws:iam:::role/,arn:aws:iam:::role/,arn:aws:iam:::role/'
```
CREATE EXTERNAL DATABASE IF NOT EXISTS
Una cláusula que crea una base de datos externa con el nombre especificado por el argumento DATABASE, si la base de datos externa especificada no existe. Si la base de datos externa especificada existe, el comando no realiza cambios. En este caso, el comando devuelve un mensaje en el que se indica que la base de datos externa existe, en lugar de terminar con un error.
No puede utilizar CREATE EXTERNAL DATABASE IF NOT EXISTS con HIVE METASTORE.
Para utilizar CREATE EXTERNAL DATABASE IF NOT EXISTS con un catálogo de datos habilitado para AWS Lake Formation, necesita tener el permiso `CREATE_DATABASE` en el catálogo de datos.
CATALOG\$1ID "*ID de la cuenta de Amazon Web Services que contiene la base de datos de Glue o Lake Formation*"
El ID de la cuenta donde se almacena la base de datos del catálogo de datos.
`CATALOG_ID` solo se puede especificar si planea conectarse al clúster de Amazon Redshift o a Amazon Redshift sin servidor mediante una identidad federada para la autenticación y la autorización del catálogo de datos estableciendo una de las siguientes opciones:
+ `CATALOG_ROLE` De a `'SESSION'`
+ `IAM_ROLE` a `'SESSION'` y `'CATALOG_ROLE'` configurado en su valor predeterminado
Para obtener más información acerca de completar los pasos para la identidad federada, consulte [Uso de una identidad federada para administrar el acceso de Amazon Redshift a los recursos locales y a las tablas externas de Amazon Redshift Spectrum](https://docs.aws.amazon.com/redshift/latest/mgmt/authorization-fas-spectrum.html).
AUTENTICACIÓN
El tipo de autenticación que se ha definido para la ingesta de streaming. La ingesta de streaming con tipos de autenticación funciona con Amazon Managed Streaming para Apache Kafka. Los tipos de `AUTHENTICATION` son los siguientes:
+ **ninguno**: especifica que no se requiere autenticación. Esto corresponde al acceso no autenticado en MSK o texto sin formato con TLS en Apache Kafka.
+ **iam**: especifica la autenticación de IAM. Al elegir esta opción, asegúrese de que el rol de IAM tenga permisos para la autenticación de IAM. Para obtener más información acerca de la definición del esquema externo, consulte [Introducción a la ingesta de transmisiones desde orígenes de Apache Kafka](materialized-view-streaming-ingestion-getting-started-MSK.md).
+ **mtls**: especifica que la seguridad de la capa de transporte mutua proporciona una comunicación segura al facilitar la autenticación entre un cliente y un servidor. En este caso, el cliente es Redshift y el servidor es Amazon MSK. Para obtener más información acerca de cómo configurar la ingesta de streaming con mTLS, consulte [Autenticación con mTLS para la ingesta de transmisiones de Redshift desde orígenes de Apache Kafka](materialized-view-streaming-ingestion-mtls.md).
AUTHENTICATION\$1ARN
El ARN del certificado AWS Certificate Manager utilizado por Amazon Redshift para la autenticación mtls con Amazon MSK. El ARN está disponible en la consola de ACM al elegir el certificado emitido.
CLUSTER\$1ARN
Para la ingesta de streaming, CLUSTER\$1ARN es el identificador del clúster de Amazon Managed Streaming para Apache Kafka desde el que está transmitiendo. Al utilizar CLUSTER\$1ARN, se requiere una política de rol de IAM que incluya el permiso `kafka:GetBootstrapBrokers`. Esta opción se proporciona por compatibilidad con versiones anteriores. Actualmente, recomendamos utilizar la opción de URI de bootstrap-broker para conectarse a clústeres de Amazon Managed Streaming para Apache Kafka. Para obtener más información, consulte [Ingesta de streaming](https://docs.aws.amazon.com/redshift/latest/dg/materialized-view-streaming-ingestion.html).
## Notas de uso
Para conocer los límites de uso del catálogo de datos de Athena, consulte [Límites de Athena](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#amazon-athena-limits) en la Referencia general de AWS.
Para conocer los límites cuando se utiliza el AWS Glue Data Catalog, consulte [Límites de AWS Glue](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_glue) en la Referencia general de AWS.
Estos límites no se aplican a un metaalmacén Hive.
Hay un máximo de 9 900 esquemas por base de datos. Para obtener más información, consulte [Cuotas y límites](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-limits.html) en la *Guía de administración de Amazon Redshift*.
Para anular el registro del esquema, utilice el comando [DROP SCHEMA](r_DROP_SCHEMA.md).
Para ver detalles de los esquemas externos, consulte las siguientes vistas del sistema:
+ [SVV\$1EXTERNAL\$1SCHEMAS](r_SVV_EXTERNAL_SCHEMAS.md)
+ [SVV\$1EXTERNAL\$1TABLES](r_SVV_EXTERNAL_TABLES.md)
+ [SVV\$1EXTERNAL\$1COLUMNS](r_SVV_EXTERNAL_COLUMNS.md)
## Ejemplos
El siguiente ejemplo crea un esquema externo utilizando una base de datos en un catálogo de datos denominado `sampledb` en la región Oeste de EE. UU. (Oregón). Utilice este ejemplo con un catálogo de datos de Athena o AWS Glue.
```
create external schema spectrum_schema
from data catalog
database 'sampledb'
region 'us-west-2'
iam_role 'arn:aws:iam::123456789012:role/MySpectrumRole';
```
En el siguiente ejemplo, se crean un esquema externo y una nueva base de datos externa denominada `spectrum_db`.
```
create external schema spectrum_schema
from data catalog
database 'spectrum_db'
iam_role 'arn:aws:iam::123456789012:role/MySpectrumRole'
create external database if not exists;
```
En el siguiente ejemplo, se crea un esquema externo a través de una base de datos de metaalmacén Hive denominada `hive_db`.
```
create external schema hive_schema
from hive metastore
database 'hive_db'
uri '172.10.10.10' port 99
iam_role 'arn:aws:iam::123456789012:role/MySpectrumRole';
```
En el siguiente ejemplo, se encadenan roles con el fin de utilizar el rol `myS3Role` para acceder a Amazon S3 y se utiliza `myAthenaRole` para acceder al catálogo de datos. Para obtener más información, consulte [Encadenamiento de roles de IAM en Amazon Redshift Spectrum](c-spectrum-iam-policies.md#c-spectrum-chaining-roles).
```
create external schema spectrum_schema
from data catalog
database 'spectrum_db'
iam_role 'arn:aws:iam::123456789012:role/myRedshiftRole,arn:aws:iam::123456789012:role/myS3Role'
catalog_role 'arn:aws:iam::123456789012:role/myAthenaRole'
create external database if not exists;
```
En el siguiente ejemplo, se crea un esquema externo que referencia una base de datos de Aurora PostgreSQL.
```
CREATE EXTERNAL SCHEMA [IF NOT EXISTS] myRedshiftSchema
FROM POSTGRES
DATABASE 'my_aurora_db' SCHEMA 'my_aurora_schema'
URI 'endpoint to aurora hostname' PORT 5432
IAM_ROLE 'arn:aws:iam::123456789012:role/MyAuroraRole'
SECRET_ARN 'arn:aws:secretsmanager:us-east-2:123456789012:secret:development/MyTestDatabase-AbCdEf'
```
En el siguiente ejemplo, se crea un esquema externo para referenciar la base de datos sales\$1db importada en el clúster consumidor.
```
CREATE EXTERNAL SCHEMA sales_schema FROM REDSHIFT DATABASE 'sales_db' SCHEMA 'public';
```
En el siguiente ejemplo, se crea un esquema externo que referencia una base de datos de Aurora MySQL.
```
CREATE EXTERNAL SCHEMA [IF NOT EXISTS] myRedshiftSchema
FROM MYSQL
DATABASE 'my_aurora_db'
URI 'endpoint to aurora hostname'
IAM_ROLE 'arn:aws:iam::123456789012:role/MyAuroraRole'
SECRET_ARN 'arn:aws:secretsmanager:us-east-2:123456789012:secret:development/MyTestDatabase-AbCdEf'
```
# CREATE EXTERNAL TABLE
Crea una nueva tabla externa en el esquema especificado. Todas las tablas externas deben crearse en un esquema externo. La ruta de búsqueda no es compatible con esquemas externos y tablas externas. Para obtener más información, consulte [CREATE EXTERNAL SCHEMA](r_CREATE_EXTERNAL_SCHEMA.md).
Además de las tablas externas creadas con el comando CREATE EXTERNAL TABLE, Amazon Redshift puede referencia tablas externas definidas en un catálogo de AWS Glue o AWS Lake Formation, o bien, en un metastore de Apache Hive. Utilice el comando [CREATE EXTERNAL SCHEMA](r_CREATE_EXTERNAL_SCHEMA.md) para registrar una base de datos externa definida en el catálogo externo y para hacer que las tablas externas estén disponibles para usarse en Amazon Redshift. Si la tabla externa ya existe en un catálogo de AWS Glue o AWS Lake Formation o en un metastore de Hive, no necesita crear la tabla con CREATE EXTERNAL TABLE. Para ver las tablas externas, consulte la vista del sistema [SVV\$1EXTERNAL\$1TABLES](r_SVV_EXTERNAL_TABLES.md).
Si ejecuta el comando CREATE EXTERNAL TABLE AS, puede crear una tabla externa basada en la definición de la columna de una consulta y escribir los resultados de esa consulta en Amazon S3. Los resultados están en Apache Parquet o formato de texto delimitado. Si la tabla externa tiene una clave o claves de partición, Amazon Redshift particiona los archivos nuevos según esas claves de partición y registra las particiones nuevas en el catálogo externo de forma automática. Para obtener más información acerca de CREATE EXTERNAL TABLE AS, consulte [Notas de uso](r_CREATE_EXTERNAL_TABLE_usage.md).
Puede consultar una tabla externa mediante la misma sintaxis SELECT que utiliza con otras tablas de Amazon Redshift. También puede utilizar la sintaxis INSERT para escribir archivos nuevos en la ubicación de la tabla externa en Amazon S3. Para obtener más información, consulte [INSERT (tabla externa)](r_INSERT_external_table.md).
Para crear una vista con una tabla externa, incluya la cláusula WITH NO SCHEMA BINDING en la instrucción [CREATE VIEW](r_CREATE_VIEW.md).
No puede ejecutar CREATE EXTERNAL TABLE en una transacción (BEGIN … END). Para obtener más información acerca de las transacciones, consulte [Niveles de aislamiento en Amazon Redshift](c_serial_isolation.md).
## Privilegios necesarios
Para crear tablas externas, debe ser el propietario del esquema externo o un superusuario. Para transferir la propiedad de un esquema externo, use ALTER SCHEMA para cambiar el propietario. El acceso a tablas externas está controlado por el acceso al esquema externo. No puede usar permisos [GRANT](r_GRANT.md) o [REVOKE](r_REVOKE.md) en una tabla externa. En su lugar, conceda o revoque USAGE en el esquema externo.
Las [Notas de uso](r_CREATE_EXTERNAL_TABLE_usage.md) tienen información adicional sobre permisos específicos para tablas externas.
## Sintaxis
```
CREATE EXTERNAL TABLE
external_schema.table_name
(column_name data_type [, …] )
[ PARTITIONED BY (col_name data_type [, … ] )]
[ { ROW FORMAT DELIMITED row_format |
ROW FORMAT SERDE 'serde_name'
[ WITH SERDEPROPERTIES ( 'property_name' = 'property_value' [, ...] ) ] } ]
STORED AS file_format
LOCATION { 's3://bucket/folder/' | 's3://bucket/manifest_file' }
[ TABLE PROPERTIES ( 'property_name'='property_value' [, ...] ) ]
```
A continuación, se muestra la sintaxis de CREATE EXTERNAL TABLE AS.
```
CREATE EXTERNAL TABLE
external_schema.table_name
[ PARTITIONED BY (col_name [, … ] ) ]
[ ROW FORMAT DELIMITED row_format ]
STORED AS file_format
LOCATION { 's3://bucket/folder/' }
[ TABLE PROPERTIES ( 'property_name'='property_value' [, ...] ) ]
AS
{ select_statement }
```
## Parameters
*external\$1schema.table\$1name*
El nombre de la tabla que se creará, clasificada por un nombre de esquema externo. Las tablas externas deben crearse en un esquema externo. Para obtener más información, consulte [CREATE EXTERNAL SCHEMA](r_CREATE_EXTERNAL_SCHEMA.md).
La longitud máxima del nombre de la tabla es de 127 bytes; los nombres más largos se truncan en 127 bytes. Puede usar caracteres multibyte UTF-8 de hasta un máximo de cuatro bytes. Amazon Redshift establece un límite de 9900 tablas por clúster, incluidas las tablas temporales definidas por el usuario y las tablas temporales creadas por Amazon Redshift durante el procesamiento de consultas o el mantenimiento del sistema. De manera opcional, puede completar el nombre de la tabla con el nombre de base de datos. En el siguiente ejemplo, el nombre de base de datos es `spectrum_db`, el nombre de esquema externo es `spectrum_schema` y el nombre de tabla es `test`.
```
create external table spectrum_db.spectrum_schema.test (c1 int)
stored as parquet
location 's3://amzn-s3-demo-bucket/myfolder/';
```
Si no existe la base de datos o el esquema especificados, no se crea la tabla y la instrucción devuelve un error. No puede crear tablas o vistas en las bases de datos del sistema `template0`, `template1`, `padb_harvest` o `sys:internal`.
El nombre de la tabla debe ser un nombre único para el esquema especificado.
Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
( *column\$1name* *data\$1type* )
El nombre y el tipo de datos de cada columna que se crea.
La longitud máxima del nombre de la columna es de 127 bytes; los nombres más largos se truncan en 127 bytes. Puede usar caracteres multibyte UTF-8 de hasta un máximo de cuatro bytes. No puede especificar nombres de columna `"$path"` o `"$size"`. Para obtener más información acerca de los nombres válidos, consulte [Nombres e identificadores](r_names.md).
De manera predeterminada, Amazon Redshift crea tablas externas con las pseudocolumnas `$path` y `$size`. Puede deshabilitar la creación de pseudocolumnas para una sesión estableciendo el parámetro de configuración `spectrum_enable_pseudo_columns` en `false`. Para obtener más información, consulte [Pseudocolumnas](r_CREATE_EXTERNAL_TABLE_usage.md#r_CREATE_EXTERNAL_TABLE_usage-pseudocolumns).
Si las pseudocolumnas están habilitadas, el número máximo de columnas que se pueden definir en una única tabla es 1 598. Si las pseudocolumnas no están habilitadas, el número máximo de columnas que se pueden definir en una única tabla es de 1600.
Si va a crear una "tabla ancha", asegúrese de que la lista de columnas no supere los límites de ancho de las filas para los resultados intermedios durante la carga y el procesamiento de consultas. Para obtener más información, consulte [Notas de uso](r_CREATE_TABLE_NEW.md#r_CREATE_TABLE_usage).
Para un comando CREATE EXTERNAL TABLE AS, no es necesaria una lista de columnas, ya que las columnas se obtienen de la consulta.
*data\$1type*
Se admiten los siguientes [Tipos de datos](c_Supported_data_types.md):
+ SMALLINT (INT2)
+ INTEGER (INT, INT4)
+ BIGINT (INT8)
+ DECIMAL (NUMERIC)
+ REAL (FLOAT4)
+ DOUBLE PRECISION (FLOAT8)
+ BOOLEAN (BOOL)
+ CHAR (CHARACTER)
+ VARCHAR (CHARACTER VARYING)
+ VARBYTE (CHARACTER VARYING): se puede usar con archivos de datos Parquet y ORC, y solo con tablas que no sean de partición.
+ DATE: solo se puede utilizar con archivos de datos de texto, Parquet u ORC, o como una columna de partición.
+ TIMESTAMP
Para DATE, puede utilizar los formatos tal y como se describe a continuación. Para los valores de mes representados mediante dígitos, se admiten los siguientes formatos:
+ `mm-dd-yyyy` por ejemplo, `05-01-2017`. Esta es la opción predeterminada.
+ `yyyy-mm-dd`, donde el año está representado por más de 2 dígitos. Por ejemplo, `2017-05-01`.
Para los valores de mes representados mediante abreviaturas de tres letras, se admiten los siguientes formatos:
+ `mmm-dd-yyyy` por ejemplo, `may-01-2017`. Esta es la opción predeterminada.
+ `dd-mmm-yyyy`, donde el año está representado por más de 2 dígitos. Por ejemplo, `01-may-2017`.
+ `yyyy-mmm-dd`, donde el año está representado por más de 2 dígitos. Por ejemplo, `2017-may-01`.
En el caso de los valores de año sistemáticamente inferiores a 100, el año se calcula de la siguiente manera:
+ Si el año es inferior a 70, el año se calcula como el año más 2000. Por ejemplo, la fecha 05-01-17 en el formato `mm-dd-yyyy` se convierte en `05-01-2017`.
+ Si el año es inferior a 100 o mayor que 69, el año se calcula como el año más 1900. Por ejemplo, la fecha 05-01-89 en el formato `mm-dd-yyyy` se convierte en `05-01-1989`.
+ Para los valores de año representados por dos dígitos, agregue ceros al principio para representar el año en 4 dígitos.
Los valores de marca temporal de los archivos de texto deben tener el formato `yyyy-mm-dd HH:mm:ss.SSSSSS`, tal y como se muestra en el siguiente valor de marca temporal: `2017-05-01 11:30:59.000000`.
La longitud de una columna VARCHAR se expresa en bytes no en caracteres. Por ejemplo, una columna VARCHAR(12) puede contener 12 caracteres de un byte o 6 caracteres de dos bytes. Cuando se realiza una consulta a una tabla externa, los resultados se truncan para ajustar el tamaño de columna sin devolver un error. Para obtener más información, consulte [Almacenamiento y rangos](r_Character_types.md#r_Character_types-storage-and-ranges).
Para obtener un rendimiento óptimo, le recomendamos que especifique el menor tamaño de columna que se adapte a sus datos. Para encontrar el tamaño máximo en bytes para los valores de una columna, use la función [OCTET\$1LENGTH](r_OCTET_LENGTH.md). El siguiente ejemplo devuelve el tamaño máximo de valores en la columna de correo electrónico.
```
select max(octet_length(email)) from users;
max
---
62
```
PARTITIONED BY (*col\$1name* *data\$1type* [, … ] )
Una cláusula que define una tabla particionada con una o más columnas de partición. Se usa un directorio de datos separado para cada combinación especificada, lo que puede mejorar el rendimiento de la consulta en algunas circunstancias. Las columnas particionadas no existen dentro de los propios datos de la tabla. Recibirá un error si utiliza un valor para *col\$1name (nombre\$1de\$1columna)* igual al de una columna de la tabla.
Después de crear una tabla con particiones, modifique la tabla mediante una instrucción [ALTER TABLE](r_ALTER_TABLE.md) … ADD PARTITION para registrar nuevas particiones en el catálogo externo. Cuando agrega una partición, define la ubicación de la subcarpeta en Amazon S3 que contiene los datos de partición.
Por ejemplo, si la tabla `spectrum.lineitem_part` se define con `PARTITIONED BY (l_shipdate date)`, ejecute el siguiente comando ALTER TABLE para agregar una partición.
```
ALTER TABLE spectrum.lineitem_part ADD PARTITION (l_shipdate='1992-01-29')
LOCATION 's3://spectrum-public/lineitem_partition/l_shipdate=1992-01-29';
```
Si utiliza CREATE EXTERNAL TABLE AS, no tendrá que ejecutar ALTER TABLE...ADD PARTITION. Amazon Redshift registra de forma automática las particiones nuevas en el catálogo externo. Amazon Redshift también escribe de forma automática los datos correspondientes en las particiones de Amazon S3 en función de la clave o las claves de partición definidas en la tabla.
Para ver particiones, consulte la vista del sistema [SVV\$1EXTERNAL\$1PARTITIONS](r_SVV_EXTERNAL_PARTITIONS.md).
Para un comando CREATE EXTERNAL TABLE AS, no es necesario especificar el tipo de datos de la columna de partición porque esta columna se obtiene de la consulta.
ROW FORMAT DELIMITED *rowformat (formato\$1de\$1fila)*
Una cláusula que especifica el formato de los datos subyacentes. Los valores posibles para *rowformat (formato\$1de\$1fila)* son los siguientes:
+ LINES TERMINATED BY '*delimiter*'
+ FIELDS TERMINATED BY '*delimiter*'
Especifique un solo carácter ASCII para '*delimiter (delimitador)*'. Puede especificar caracteres ASCII no imprimibles mediante octales, con el formato `'\`*`ddd`*`'`, donde *`d`* es un dígito octal (0-7) hasta “\$1177”. El siguiente ejemplo especifica el carácter BEL (campana) usando la representación octal.
```
ROW FORMAT DELIMITED FIELDS TERMINATED BY '\007'
```
Si se omite ROW FORMAT DELIMITED, el formato predeterminado es DELIMITED FIELDS TERMINATED BY '\$1A' (inicio de encabezado) y LINES TERMINATED BY '\$1n' (nueva línea).
ROW FORMAT SERDE '*serde\$1name (nombre\$1de\$1serde)*' [WITH SERDEPROPERTIES ( '*property\$1name*' = '*property\$1value*' [, ...] ) ]
Una cláusula que especifica el formato SERDE para los datos subyacentes.
'*serde\$1name (nombre\$1de\$1serde*'
El nombre del SerDe. Puede especificar los siguientes formatos:
+ org.apache.hadoop.hive.serde2.RegexSerDe
+ com.amazonaws.glue.serde.GrokSerDe
+ org.apache.hadoop.hive.serde2.OpenCSVSerde
Este parámetro admite la siguiente propiedad SerDE para OpenCSvSerde:
```
'wholeFile' = 'true'
```
Configure la propiedad `wholeFile` como `true` para analizar correctamente los nuevos caracteres de línea (\$1n) dentro de las cadenas citadas para las solicitudes OpenCSV.
+ org.openx.data.jsonserde.JsonSerDe
+ El SERDE JSON también admite archivos Ion.
+ El JSON debe tener un formato correcto.
+ Las marcas temporales en Ion y JSON deben usar el formato ISO8601.
+ Este parámetro admite la siguiente propiedad SerDE para JsonSerDe:
```
'strip.outer.array'='true'
```
Procesa archivos Ion/JSON que contienen una matriz muy grande encerrada en corchetes exteriores ([ … ]) como si contiene múltiples registros JSON dentro de la matriz.
+ com.amazon.ionhiveserde.IonHiveSerDe
El formato Amazon ION proporciona formatos de texto y binarios, además de tipos de datos. Para una tabla externa que hace referencia a datos en formato ION, debe asignar cada columna en la tabla externa al elemento correspondiente de los datos de formato ION. Para obtener más información, consulte [Amazon Ion](https://amzn.github.io/ion-docs/). También debe especificar los formatos de entrada y salida.
WITH SERDEPROPERTIES ( '*property\$1name*' = '*property\$1value*' [, ...] ) ]
De manera opcional, especifique los nombres y valores de las propiedades, separados por comas.
Si se omite ROW FORMAT DELIMITED, el formato predeterminado es DELIMITED FIELDS TERMINATED BY '\$1A' (inicio de encabezado) y LINES TERMINATED BY '\$1n' (nueva línea).
STORED AS *file\$1format*
El formato de archivo para los archivos de datos.
Los formatos válidos son los siguientes:
+ PARQUET
+ RCFILE (para datos que usan ColumnarSerDe únicamente, no LazyBinaryColumnarSerDe)
+ SEQUENCEFILE
+ TEXTFILE (para archivos de texto, incluidos los archivos JSON).
+ ORC
+ AVRO
+ INPUTFORMAT '*input\$1format\$1classname*' OUTPUTFORMAT '*output\$1format\$1classname*'
El comando CREATE EXTERNAL TABLE AS solo admite dos formatos de archivo, TEXTFILE y PARQUET.
Para INPUTFORMAT y OUTPUTFORMAT, especifique un nombre de la clase, como se muestra en el siguiente ejemplo:
```
'org.apache.hadoop.mapred.TextInputFormat'
```
LOCATION \$1 's3://*bucket/folder*/' \$1 's3://*bucket/manifest\$1file*'\$1
Se trata de la ruta a la carpeta o al bucket de Amazon S3 que contiene los archivos de datos o un archivo de manifiesto donde se incluye una lista de rutas de objetos de Amazon S3. Los buckets deben estar en la misma región de AWS que el clúster de Amazon Redshift. Para obtener una lista de las regiones de AWS admitidas, consulte [Limitaciones de Amazon Redshift Spectrum](c-spectrum-considerations.md).
Si la ruta especifica un bucket o una carpeta, por ejemplo, `'s3://amzn-s3-demo-bucket/custdata/'`, Redshift Spectrum analiza los archivos en el bucket o la carpeta especificados, además de todas las subcarpetas. Redshift Spectrum omite los archivos ocultos y los archivos que comienzan con un carácter de subrayado.
Si la ruta especifica un archivo de manifiesto, el argumento `'s3://bucket/manifest_file'` debe referencia de forma explícita un solo archivo; por ejemplo, `'s3://amzn-s3-demo-bucket/manifest.txt'`. No puede hacer referencia a un prefijo de clave.
El manifiesto es un archivo de texto en formato JSON que muestra la dirección URL de cada archivo que se va a cargar desde Amazon S3 y el tamaño del archivo, en bytes. El URL incluye el nombre del bucket y la ruta de objeto completa para el archivo. Los archivos que se especifican en el manifiesto pueden estar en buckets diferentes, pero todos los buckets deben estar en la misma región de AWS que el clúster de Amazon Redshift. Si un archivo aparece dos veces, este se carga dos veces. En el siguiente ejemplo, se muestra el JSON para un manifiesto que carga tres archivos.
```
{
"entries": [
{"url":"s3://amzn-s3-demo-bucket1/custdata.1", "meta": { "content_length": 5956875 } },
{"url":"s3://amzn-s3-demo-bucket1/custdata.2", "meta": { "content_length": 5997091 } },
{"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
]
}
```
Puede hacer que la inclusión de un archivo en particular sea obligatoria. Para ello, incluya una opción `mandatory` en el nivel de archivo en el manifiesto. Cuando consulta una tabla externa con un archivo obligatorio faltante, se produce un error en la instrucción SELECT. Asegúrese de que todos los archivos incluidos en la definición de la tabla externa están presentes. Si no están todos presentes, aparece un error que muestra el primer archivo obligatorio que no se encuentra. En el siguiente ejemplo, se muestra el JSON de un manifiesto con la opción `mandatory` establecida en `true`.
```
{
"entries": [
{"url":"s3://amzn-s3-demo-bucket1/custdata.1", "mandatory":true, "meta": { "content_length": 5956875 } },
{"url":"s3://amzn-s3-demo-bucket1/custdata.2", "mandatory":false, "meta": { "content_length": 5997091 } },
{"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
]
}
```
Para hacer referencia a los archivos creados mediante UNLOAD, puede usar el manifiesto creado mediante [UNLOAD](r_UNLOAD.md) con el parámetro MANIFEST. El archivo de manifiesto es compatible con un archivo de manifiesto de [COPY de Amazon S3](copy-parameters-data-source-s3.md), pero usa claves diferentes. Las claves que no se usan se omiten.
TABLE PROPERTIES ( '*property\$1name*'='*property\$1value*' [, ...] )
Una cláusula que establece la definición de tabla de las propiedades de la tabla.
Las propiedades de tabla distinguen entre mayúsculas y minúsculas.
'compression\$1type'='*value (valor)*'
Propiedad que establece el tipo de compresión que se va a utilizar si el nombre de archivo no contiene una extensión. Si establece esta propiedad y hay una extensión de archivo, la extensión se omite y se usa el valor establecido por la propiedad. Los valores válidos para el tipo de compresión son los siguientes:
+ bzip2
+ gzip
+ none
+ snappy
“data\$1cleansing\$1enabled”=“true/false”
Esta propiedad establece si el control de datos está activado para la tabla. Cuando “data\$1cleansing\$1enabled” se establece en true, el control de datos está activado para la tabla. Cuando “data\$1cleansing\$1enabled” se establece en false, el control de datos está desactivado para la tabla. A continuación, se muestra una lista de las propiedades de control de datos en el nivel de la tabla que controla esta propiedad:
+ column\$1count\$1mismatch\$1handling
+ invalid\$1char\$1handling
+ numeric\$1overflow\$1handling
+ replacement\$1char
+ surplus\$1char\$1handling
Para ver ejemplos, consulte [Ejemplos de control de datos](r_CREATE_EXTERNAL_TABLE_examples.md#r_CREATE_EXTERNAL_TABLE_examples-data-handling).
“invalid\$1char\$1handling”=“*valor*”
Especifica la acción que se debe realizar cuando los resultados de la consulta contienen valores de caracteres UTF-8 no válidos. Puede especificar las siguientes acciones:
DISABLED
No lleva a cabo un control de caracteres no válido.
FAIL
Cancela las consultas que devuelven datos que contienen valores UTF-8 no válidos.
SET\$1TO\$1NULL
Reemplaza los valores UTF-8 no válidos por valores nulos.
DROP\$1ROW
Reemplaza cada valor de la fila por un valor nulo.
REPLACE
Reemplaza el carácter no válido por el carácter de reemplazo que se especifique mediante `replacement_char`.
“replacement\$1char”=“*carácter*”
Especifica el carácter de reemplazo que se va a utilizar al establecer `invalid_char_handling` en `REPLACE`.
“numeric\$1overflow\$1handling”=“valor”
Especifica la acción que se debe realizar cuando los datos de ORC contienen un entero (por ejemplo, BIGINT o int64) que es mayor que la definición de columna (por ejemplo, SMALLINT o int16). Puede especificar las siguientes acciones:
DISABLED
El control de caracteres no válidos está desactivado.
FAIL
Cancela la consulta cuando los datos incluyen caracteres no válidos.
SET\$1TO\$1NULL
Establece caracteres no válidos en valores nulos.
DROP\$1ROW
Establece cada valor de la fila como un valor nulo.
'surplus\$1bytes\$1handling'='*valor*'
Especifica cómo controlar los datos que se cargan que superan la longitud del tipo de datos definido para las columnas que contienen datos VARBYTE. De manera predeterminada, Redshift Spectrum establece el valor como nulo para los datos que superan el ancho de la columna.
Puede especificar las siguientes acciones que se realizarán cuando la consulta devuelva datos que superen la longitud del tipo de datos:
SET\$1TO\$1NULL
Reemplaza los datos que superan el ancho de la columna por valores nulos.
DISABLED
No lleva a cabo un control de bytes sobrantes.
FAIL
Cancela las consultas que devuelven datos que superan el ancho de la columna.
DROP\$1ROW
Elimina todas las filas que contienen datos que superan la anchura de columna.
TRUNCATE
Elimina los caracteres que superan el número máximo de caracteres definidos para la columna.
“surplus\$1char\$1handling”=“*valor*”
Especifica cómo controlar los datos que se cargan que superan la longitud del tipo de datos definido para las columnas que contienen datos VARCHAR, CHAR o cadenas. De manera predeterminada, Redshift Spectrum establece el valor como nulo para los datos que superan el ancho de la columna.
Puede especificar las siguientes acciones que se deben realizar cuando la consulta devuelva datos que superan el ancho de la columna:
SET\$1TO\$1NULL
Reemplaza los datos que superan el ancho de la columna por valores nulos.
DISABLED
No lleva a cabo un control de caracteres sobrantes.
FAIL
Cancela las consultas que devuelven datos que superan el ancho de la columna.
DROP\$1ROW
Reemplaza cada valor de la fila por un valor nulo.
TRUNCATE
Elimina los caracteres que superan el número máximo de caracteres definidos para la columna.
'column\$1count\$1mismatch\$1handling'='value’
Identifica si el archivo contiene menos o más valores para una fila que el número de columnas especificado en la definición de tabla externa. Esta propiedad solo está disponible para un formato de archivo de texto sin comprimir. Puede especificar las siguientes acciones:
DISABLED
El control de discrepancias en el recuento de columnas está desactivado.
FAIL
No se puede realizar la consulta si se detecta una discrepancia en el recuento de columnas.
SET\$1TO\$1NULL
Rellene los valores que faltan con NULL e ignore los valores adicionales de cada fila.
DROP\$1ROW
Elimine del análisis todas las filas que contengan un error de discrepancia en el recuento de columnas.
'numRows'='*row\$1count*'
Una propiedad que establece el valor de numRows para la definición de la tabla. Para actualizar de forma explícita las estadísticas de una tabla externa, establezca la propiedad numRows de manera que indique el tamaño de la tabla. Amazon Redshift no analiza las tablas externas para generar las estadísticas de las tablas que el optimizador de consultas emplea a la hora de crear un plan de consulta. Si no se configuran las estadísticas de tabla para una tabla externa, Amazon Redshift genera un plan de ejecución de consulta basado en un supuesto de que las tablas externas son las más grandes y las tablas locales son las más pequeñas.
'skip.header.line.count'='*line\$1count*'
Una propiedad que establece el número de filas que se omiten al principio de cada archivo de código fuente.
'serialization.null.format'=' '
Una propiedad que especifica que Spectrum debe devolver un valor `NULL` cuando hay una coincidencia exacta con el texto introducido en un campo.
'orc.schema.resolution'='mapping\$1type' (tipo\$1de\$1asignación)
Propiedad que establece el tipo de asignación de columnas en tablas que usan el formato de datos de ORC. Esta propiedad se omite con otros formatos de datos.
Los valores válidos para el tipo de asignación de columnas son los siguientes:
+ name
+ position
Si la propiedad *orc.schema.resolution* se omite, las columnas se asignan por nombre de manera predeterminada. Si *orc.schema.resolution* se establece en un valor que no es *'name'* ni *'position'*, las columnas se asignan por posición. Para obtener más información sobre la asignación de columnas, consulte [Asignación de columnas de tablas externas a columnas ORC](c-spectrum-external-tables.md#c-spectrum-column-mapping-orc).
El comando COPY realiza asignaciones en archivos de datos de ORC únicamente por posición. La propiedad de tabla *orc.schema.resolution* no tiene ningún efecto en el comportamiento del comando COPY.
'write.parallel'='on / off’
Una propiedad que establece si CREATE EXTERNAL TABLE AS debe escribir datos en paralelo. De manera predeterminada, CREATE EXTERNAL TABLE AS escribe datos en paralelo en varios archivos, según el número de sectores en el clúster. La opción predeterminada está activada. Cuando 'write.parallel' está desactivado, CREATE EXTERNAL TABLE AS escribe en uno o más archivos de datos en serie en Amazon S3. Esta propiedad de tabla también se aplica a cualquier instrucción INSERT posterior en la misma tabla externa.
‘write.maxfilesize.mb’=‘size’
Se trata de una propiedad que establece el tamaño máximo (en MB) de cada archivo escrito en Amazon S3 con CREATE EXTERNAL TABLE AS. El tamaño debe ser un entero válido entre 5 y 6200. El tamaño máximo de archivo predeterminado es 6200 MB. Esta propiedad de tabla también se aplica a cualquier instrucción INSERT posterior en la misma tabla externa.
'write.kms.key.id'='*value*'
Puede especificar una clave AWS Key Management Service para habilitar el cifrado del lado del servidor (SSE) para objetos de Amazon S3, donde *value* es una de las opciones siguientes:
+ `auto` para utilizar la clave de AWS KMS predeterminada almacenada en el bucket de Amazon S3
+ *clave de kms* especficada para cifrar los datos
*select\$1statement*
Una instrucción que inserta una o más filas en la tabla externa definiendo cualquier consulta. Todas las filas que genera la consulta se escriben en Amazon S3 en formato de texto o Parquet según la definición de tabla.
## Ejemplos
Encontrará una selección de ejemplos en [Ejemplos](r_CREATE_EXTERNAL_TABLE_examples.md).
# Notas de uso
Este tema contiene notas de uso para [CREATE EXTERNAL TABLE](r_CREATE_EXTERNAL_TABLE.md). No puede ver los detalles de las tablas de Amazon Redshift Spectrum con los mismos recursos que utiliza para las tablas de Amazon Redshift estándar, como [PG\$1TABLE\$1DEF](r_PG_TABLE_DEF.md), [STV\$1TBL\$1PERM](r_STV_TBL_PERM.md), PG\$1CLASS o information\$1schema. Si su herramienta de análisis o inteligencia empresarial no reconoce las tablas externas de Redshift Spectrum, configure la aplicación para consultar [SVV\$1EXTERNAL\$1TABLES](r_SVV_EXTERNAL_TABLES.md) y [SVV\$1EXTERNAL\$1COLUMNS](r_SVV_EXTERNAL_COLUMNS.md).
## CREATE EXTERNAL TABLE AS
En algunos casos, puede ejecutar el comando CREATE EXTERNAL TABLE AS en un catálogo de datos de AWS Glue, un catálogo externo de AWS Lake Formation o un metastore de Apache Hive. En tales casos, se utiliza un rol de AWS Identity and Access Management (IAM) para crear el esquema externo. Este rol de IAM debe tener permisos de lectura y escritura en Amazon S3.
Si utiliza un catálogo de Lake Formation, el rol de IAM debe tener permiso para crear tablas en el catálogo. En este caso, también debe tener el permiso de ubicación del lago de datos en la ruta de destino de Amazon S3. Este rol de IAM se convierte en el propietario de la nueva tabla AWS Lake Formation.
Para asegurarse de que los nombres de los archivos son únicos, Amazon Redshift utiliza el siguiente formato para el nombre de cada archivo cargado en Amazon S3 de manera predeterminada.
`_