Aggiunta di metadati ai file di storage degli oggetti per il filtro di ricerca

I metadati sono definiti come coppie chiave-valore. Per utilizzare i metadati con i file di storage degli oggetti, è innanzitutto necessario definire i campi di metadati in un file di schema. Quindi, associ i file nel bucket ai valori dei metadati.

Per tutti i metodi di metadati dello storage degli oggetti, è necessario creare un file di schema dei metadati denominato _metadata_schema.json al livello radice del bucket dello storage degli oggetti. Lo schema definisce le chiavi di metadati che il servizio può prevedere e il tipo di valore per ogni chiave.

Se il file _metadata_schema.json non esiste, i metadati non vengono calcolati per i file nel bucket.

Ogni campo di metadati ha un nome e un tipo. Di seguito sono riportati i tipi di metadati supportati.

• integer
• string
• list_of_string
• double

Utilizzare il workflow seguente per preparare i metadati prima di sincronizzare i file in una memoria di vettore:

1. In un editor di testo, creare un file di schema dei metadati denominato _metadata_schema.json.
2. Definire i campi di metadati e i tipi di valore in formato JSON.
3. Caricare _metadata_schema.json nel livello radice del bucket di storage degli oggetti che contiene i file da sincronizzare.
4. Selezionare come associare i valori dei metadati ai file:
   • Applica metadati comuni a tutti i file nel bucket.
   • Definire i metadati per diversi file in un unico file JSON.
   • Definire i metadati in un file JSON separato per ogni file di dati.
   • Aggiungere i metadati utilizzando le proprietà dei metadati dello storage degli oggetti.
5. Caricare i file di metadati nella posizione corretta nel bucket di storage degli oggetti.
6. Eseguire la sincronizzazione dei dati per la memoria di vettore.

Creare un file di schema dei metadati denominato _metadata_schema.json e salvarlo al livello radice del bucket di storage degli oggetti.

{
  "metadataSchema": [
    {
      "name": "publication_year",
      "type": "integer"
    },
    {
      "name": "title",
      "type": "string"
    },
    {
      "name": "topic",
      "type": "list_of_string"
    },
    {
      "name": "rating",
      "type": "double"
    }
  ]
}

I nomi dei metadati utilizzati nei file di metadati devono corrispondere ai nomi definiti nello schema.

Nella tabella riportata di seguito vengono descritti i metodi supportati per l'aggiunta di metadati ai file nello storage degli oggetti, inclusa la posizione in cui creare ciascun file di metadati o intestazione e quando utilizzare ciascun metodo.

L'esempio riportato di seguito mostra dove salvare i file di metadati in un bucket di storage degli oggetti.

bucket_root/
  _metadata_schema.json
  _common.metadata.json
  _all.metadata.json
  file_0.pdf
  file_0.pdf.metadata.json
  folder_1/
    file_1.pdf
    file_1.pdf.metadata.json
  folder_2/
    file_2.pdf
    file_2.pdf.metadata.json

Per i metadati specifici del file, il file di metadati deve essere salvato allo stesso livello del file di dati corrispondente.

Ad esempio, se il file di dati viene salvato come segue:

folder_1/file_1.pdf

il file di metadati deve essere salvato come indicato di seguito.

folder_1/file_1.pdf.metadata.json

Metadati comuni per tutti i file

Creare _common.metadata.json al livello radice del bucket per applicare gli stessi metadati a tutti i file nel bucket.

Esempio:

{
  "metadataAttributes": {
    "publication_year": 2020,
    "topic": [
      "cooking",
      "health",
      "gardening"
    ],
    "rating": 3.3
  }
}

Metadati per più file

Creare _all.metadata.json al livello radice del bucket per definire i metadati per diversi file in un unico file JSON.

Esempio:

{
  "folder_1/file_1.pdf": {
    "metadataAttributes": {
      "publication_year": 2020,
      "title": "Healthy Cooking Guide",
      "topic": [
        "cooking",
        "health"
      ],
      "rating": 4.5
    }
  },
  "folder_2/file_2.pdf": {
    "metadataAttributes": {
      "publication_year": 2022,
      "title": "Gardening Basics",
      "topic": [
        "gardening"
      ],
      "rating": 4.0
    }
  }
}

Metadati per un file

Creare <file-name>.metadata.json allo stesso livello del file di dati corrispondente.

Ad esempio, per definire i metadati per file_1.pdf, creare un file denominato file_1.pdf.metadata.json.

Esempio:

{
  "metadataAttributes": {
    "publication_year": 2020,
    "title": "Healthy Cooking Guide",
    "topic": [
      "cooking",
      "health"
    ],
    "rating": 4.5
  }
}

I limiti riportati di seguito si applicano ai metadati utilizzati per l'applicazione di filtri di ricerca.

Aggiungere lo schema dei metadati e i file di metadati prima di sincronizzare i dati nella memoria di vettore.

Dopo la sincronizzazione dei file, i metadati sono disponibili per l'applicazione di filtri di ricerca. Se si aggiungono o si modificano i metadati dopo la sincronizzazione, eseguire di nuovo la sincronizzazione dei dati in modo che i metadati aggiornati vengano inclusi nella memoria di vettore.

Per sincronizzare i file dallo storage degli oggetti, vedere Sincronizzazione dei dati in un'area di memorizzazione vettore.