Creación de un espacio de nombres - Amazon Simple Storage Service

Creación de un espacio de nombres

Un espacio de nombres de tablas es un constructo lógico bajo el cual se agrupan tablas en un bucket de tablas de Amazon S3. Cada tabla pertenece a un único espacio de nombres. Antes de crear una tabla en un bucket de tablas, debe crear un espacio de nombres bajo el cual agrupar las tablas. Puede crear un espacio de nombres mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI), la API de REST de Amazon S3, los SDK de AWS o los motores de consulta integrados.

Nombres de espacio de nombres

Las siguientes reglas de nomenclatura se aplican a los espacios de nombres:

  • Los nombres deben tener entre 1 y 255 caracteres.

  • Los nombres solo pueden constar de letras minúsculas, números y guiones bajos (_). No se permite el uso de guiones bajos al principio o al final de los nombres de espacios de nombres.

  • Los nombres deben comenzar y terminar con una letra o un número.

  • Los nombres no deben contener guiones (-) ni puntos (.).

  • Un espacio de nombres debe ser único en un bucket de tablas.

  • Los nombres de espacios de nombres no deben comenzar con el prefijo reservado aws. Por ejemplo, no puede utilizar aws_s3_metadata como espacio de nombres. aws_s3_metadata es un espacio de nombres reservado para tablas de metadatos. Para obtener más información, consulte Aceleración del descubrimiento de datos con Metadatos de S3.

Para obtener más información acerca de los nombres de espacios de nombres válidos, consulte Reglas de nomenclatura para tablas y espacios de nombres.

El siguiente procedimiento utiliza el flujo de trabajo Crear tabla con Athena para crear un espacio de nombres en la consola de Amazon S3. Si no desea utilizar también Amazon Athena para crear una tabla en su espacio de nombres, puede cancelar el flujo de trabajo después de crear el espacio de nombres.

Para crear un espacio de nombres

  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

  2. En el panel de navegación izquierdo, elija Buckets de tablas.

  3. En la página Buckets de tablas, seleccione el bucket en el cual desea crear un espacio de nombres.

  4. En la página de detalles del bucket, seleccione Crear tabla con Athena.

  5. En el cuadro de diálogo Crear tabla con Athena, elija Crear un espacio de nombres y, a continuación, elija Crear espacio de nombres.

  6. Escriba un nombre en el campo Nombre del espacio de nombres. Los nombres de los espacios de nombres deben tener entre 1 y 255 caracteres y ser únicos dentro del bucket de tablas. Los caracteres válidos son a-z, 0-9 y guion bajo (_). No se permite el uso de guiones bajos al principio o al final de los nombres de espacios de nombres.

  7. Elija Crear espacio de nombres.

  8. Si también quiere crear una tabla, elija Crear tabla con Athena. Para obtener más información acerca de cómo crear una tabla con Athena, consulte Uso de la consola de S3 y Amazon Athena. Si no desea crear una tabla en este momento, elija Cancelar.

En este ejemplo se muestra cómo crear un espacio de nombres de tablas con la AWS CLI. Para utilizar este ejemplo, reemplace los user input placeholders con su propia información.

aws s3tables create-namespace \
    --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-bucket1 \ 
    --namespace example_namespace

Puede crear un espacio de nombres en una sesión de Apache Spark conectada a los buckets de tablas de Amazon S3.

En este ejemplo se muestra cómo crear una tabla con instrucciones CREATE en un motor de consulta integrado con Tablas de S3. Para utilizar este ejemplo, reemplace los marcadores de posición de entrada del usuario con su propia información.

spark.sql("CREATE NAMESPACE IF NOT EXISTS s3tablesbucket.my_namespace")