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/).
# 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).