# Creación de un espacio de nombres
<a name="s3-tables-namespace-create"></a>

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`.

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](s3-tables-buckets-naming.md#naming-rules-table).

## Uso de la consola de S3 y Amazon Athena
<a name="create-namespace-console"></a>

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 Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

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

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

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

1. 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**.

1. 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.

1. Elija **Crear espacio de nombres**.

1. 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](s3-tables-create.md#create-table-console). Si no desea crear una tabla en este momento, elija **Cancelar**.

## Uso de AWS CLI
<a name="create-table-namespace-CLI"></a>

En este ejemplo se muestra cómo crear un espacio de nombres de tablas con la AWS CLI. Para utilizar este ejemplo, sustituya `user input placeholders` por 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
```

## Uso de un motor de consultas
<a name="create-table-namespace-engine"></a>

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")
```