Creazione di un namespace - Amazon Simple Storage Service

Creazione di un namespace

Il namespace di una tabella è un costrutto logico in base al quale raggruppare le tabelle in un bucket di tabelle Amazon S3. Ogni tabella appartiene a un singolo spazio dei nomi. Prima di creare una tabella in un bucket di tabelle, è necessario creare un namespace per raggruppare le tabelle. È possibile creare un namespace utilizzando la console Amazon S3, AWS Command Line Interface (AWS CLI), REST API di Amazon S3, AWS SDK o i motori di query integrati.

Nomi degli spazi dei nomi

Per la denominazione degli spazi dei nomi si applicano le seguenti regole:

  • I nomi devono contenere un numero di caratteri compreso tra 1 e 255.

  • I nomi possono includere solo lettere minuscole, numeri e caratteri di sottolineatura (_). I caratteri di sottolineatura non sono consentiti all’inizio o alla fine dei nomi dei namespace.

  • I nomi devono iniziare e terminare con una lettera o un numero.

  • I nomi non devono contenere trattini (-) o punti (.).

  • Uno spazio dei nomi deve essere univoco all'interno di un bucket di tabelle.

  • I nomi dei namespace non devono iniziare con il prefisso riservato aws.

Per ulteriori informazioni sui nomi di namespace validi, consulta Regole di denominazione per tabelle e spazi dei nomi.

La procedura seguente utilizza il flusso di lavoro Crea tabella con Athena per creare un namespace nella console Amazon S3. Se non si desidera utilizzare Amazon Athena per creare la tabella nel namespace, è possibile annullare il flusso di lavoro dopo aver creato il namespace.

Per creare uno spazio dei nomi

  1. Accedi alla Console di gestione AWS e apri la console Amazon S3 all’indirizzo https://console.aws.amazon.com/s3/.

  2. Nel pannello di navigazione a sinistra, scegli Bucket di tabelle.

  3. Nella pagina Bucket di tabelle, scegli il bucket in cui desideri creare un namespace.

  4. Nella pagina dei dettagli del bucket, scegli Crea tabella con Athena.

  5. Nella finestra di dialogo Crea tabella con Athena, scegli Crea un namespace, quindi seleziona Crea namespace.

  6. Immetti un nome nel campo Nome del namespace. I nomi dei namespace devono essere composti da un numero di caratteri compreso tra 1 e 255 ed essere univoci all’interno del bucket di tabelle. I caratteri validi sono a-z, 0-9 e i caratteri di sottolineatura (_). I caratteri di sottolineatura non sono consentiti all’inizio o alla fine dei nomi dei namespace.

  7. Selezionare Create namespace (Crea spazio dei nomi).

  8. Se desideri creare anche una tabella, scegli Crea tabella con Athena. Per ulteriori informazioni sulla creazione di una tabella con Athena, consulta Utilizzo della console S3 e Amazon Athena. Se non desideri creare una tabella in questo momento, scegli Annulla.

In questo esempio viene mostrato come creare lo spazio dei nomi di una tabella utilizzando AWS CLI. Per utilizzare questo esempio, sostituisci user input placeholders con le informazioni appropriate.

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

È possibile creare uno spazio dei nomi in una sessione di Apache Spark connessa ai bucket delle tabelle Amazon S3.

Questo esempio mostra come creare una tabella utilizzando istruzioni CREATE in un motore di query integrato con Tabelle S3. Per utilizzare questo esempio, sostituisci i segnaposto inseriti dall’utente con le informazioni appropriate.

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