Importare dal proprio bucket di archiviazione

Se i Suoi documenti si trovano già in un archivio a oggetti (S3, o qualsiasi cosa parli la stessa API), ci indichi il bucket invece di caricare i file uno alla volta. Li leggiamo dove sono. Registra un bucket una volta sola in Your storage, poi importa da lì tutte le volte che vuole.

Che cosa preparare dalla Sua parte#

1. Una cartella all'interno del bucket che contenga i file da indicizzare: handbook/policies/ anziché l'intero bucket, a meno che l'intero bucket non sia proprio ciò che intende. È il prefix, se la Sua archiviazione lo chiama così.
2. Una chiave di accesso che possa leggere soltanto quella cartella. Un'importazione elenca il contenuto della cartella e legge gli oggetti al suo interno, e non può fare altro. Non scriviamo mai nel Suo bucket, non cancelliamo mai nulla al suo interno e non leggiamo mai al di fuori della cartella che ha registrato.

Poi selezioni Register a bucket e compili:

• Host di archiviazione. L'host su cui risponde la Sua archiviazione, da solo: senza schema davanti, senza il bucket e senza percorso al suo interno. Ci colleghiamo sempre via https, perché qualsiasi altra cosa metterebbe in chiaro sulla rete la Sua chiave di accesso. Un indirizzo su una rete privata viene rifiutato al momento della registrazione e verificato di nuovo, rispetto all'indirizzo che raggiungiamo davvero, a ogni importazione.
• Bucket e Regione, se la Sua archiviazione ha regioni.
• Cartella. Un confine, non solo un punto di partenza. Un'importazione può restringerla (è ciò che fa Only this folder nell'importazione stessa) ma non allargarla mai, quindi una sorgente registrata su handbook/ non potrà mai essere convinta a leggere il resto del bucket.
• Access key id e Secret access key.

Che fine fa il secret#

Il secret è di sola scrittura. Viene conservato cifrato e nulla nel prodotto lo rilegge: né l'elenco delle sorgenti, né la sorgente stessa, né l'API dei secret. In seguito può vedere che una chiave è memorizzata, mai quale sia: per questo il campo è vuoto ogni volta che riapre la sorgente.

Quindi non possiamo recuperarne uno per Lei. Per ruotare una chiave, scriva il nuovo secret sopra quello vecchio; lasciando il campo vuoto si mantiene la chiave che già abbiamo. Non c'è modo di rimuoverla lasciando la sorgente al suo posto, perché una sorgente senza chiave non può importare nulla.

Un'importazione è un documento#

Ogni file sotto la cartella entra a far parte di un unico documento, allo stesso modo in cui la scansione di un intero sito web diventa un solo documento fatto di molte pagine. Ogni passaggio conserva comunque il file da cui proviene, così una risposta cita il file esatto. Se vuole un documento per file, importi una cartella più stretta per ogni documento.

Il documento compare subito nella raccolta, come bozza, e la scheda Processing mostra l'importazione in corso. Nulla è ricercabile finché l'attività non termina e Lei non pubblica, esattamente come per un caricamento.

Valgono i limiti di caricamento del Suo piano: lo stesso tetto di dimensione per file e un limite massimo al numero di file che una singola importazione legge. Il raggiungimento di quel limite viene segnalato sull'attività come avviso e non come errore, quindi restringa la cartella e importi il resto separatamente.

Importare di nuovo per recepire le modifiche#

Importi di nuovo nello stesso documento ogni volta che il bucket è andato avanti. Ogni file viene confrontato con quello che già conserviamo: uno il cui contenuto non è cambiato non viene scaricato di nuovo né indicizzato di nuovo e, se sotto la cartella non è cambiato proprio nulla, l'attività termina senza aver scritto niente. È abbastanza economico da ripetere ogni volta che vuole.

Importare di nuovo non è una modifica. Il titolo, le etichette e lo stato di pubblicazione restano come li ha impostati.

La reindicizzazione è un'altra cosa, ed è qui che si commette l'errore. La reindicizzazione ricostruisce i passaggi a partire dalle copie che già conserviamo e non dal Suo bucket, quindi non può vedere un file che lì ha aggiunto, modificato o eliminato. Esiste un'eccezione, e non è una scorciatoia: se le nostre copie di un documento sono andate perdute, una reindicizzazione rilegge il bucket per ricostruirle, e l'attività lo dichiara. È l'importazione a leggere la Sua archiviazione.

Modificare o rimuovere una sorgente#

Modificare una sorgente (un nuovo host, un bucket diverso, una chiave ruotata) cambia ciò che leggerà la prossima importazione e lascia tutto ciò che è già indicizzato esattamente com'è.

Eliminare una sorgente cancella la registrazione e la chiave memorizzata, e nient'altro. L'operazione viene rifiutata finché esiste anche un solo documento importato da quella sorgente, e il rifiuto ne indica uno per nome. È voluto: quei documenti sono il Suo contenuto indicizzato, ed eliminare un elemento di configurazione non deve mai distruggerli. Elimini prima i documenti che non vuole più, poi rimuova la sorgente.

Nulla all'interno del Suo bucket viene mai modificato, qualunque cosa faccia qui. Ci limitiamo sempre a leggerlo.