Integrazione Azure Blob Storage#
L'integrazione Azure Blob Storage collega i contenitori del tuo account di archiviazione a Ultralytics Platform. Le immagini restano nei tuoi contenitori: Platform le indicizza sul posto, così puoi consultarle, annotarle e addestrare modelli YOLO senza caricarne una copia.
I dataset Azure Blob Storage richiedono un piano Pro o Enterprise. I workspace gratuiti visualizzano l'integrazione e ricevono una richiesta di upgrade al momento della connessione. Se un abbonamento termina, i dataset Azure Blob Storage esistenti restano completamente accessibili: solo le nuove connessioni e importazioni richiedono Pro.
Ottieni una stringa di connessione#
Platform legge soltanto i dati dal tuo spazio di archiviazione: non scrive, modifica o elimina mai i tuoi blob. L'integrazione attuale richiede una stringa di connessione con chiave di accesso all'account, che concede privilegi sull'intero account anche se Platform esegue solo operazioni di elenco e lettura:
- Nel portale Azure, apri il tuo account di archiviazione.
- Vai a Sicurezza e rete > Chiavi di accesso.
- Copia una stringa di connessione.
La stringa deve includere AccountName, AccountKey e HTTPS come protocollo: si tratta del formato fornito da Azure nella sezione Chiavi di accesso. Le stringhe di connessione con token SAS, che contengono SharedAccessSignature invece di AccountKey, vengono rifiutate.
Le connessioni usano l'endpoint standard blob.core.windows.net. I cloud sovrani (Azure Cina, Azure Government) e gli endpoint blob personalizzati non sono supportati.
Connettiti a Platform#
- Vai a Impostazioni > Integrazioni e seleziona Azure Blob Storage nell'elenco delle integrazioni.
- Incolla la stringa di connessione.
- Fai clic su Trova contenitori disponibili, poi seleziona i contenitori da collegare. Puoi anche inserire manualmente il nome di un contenitore.
- Fai clic su Connetti. Prima di salvare, Platform verifica di poter elencare e leggere ogni contenitore selezionato.
Per collegare lo spazio di archiviazione cloud, ti serve il ruolo di amministratore o proprietario del workspace. Puoi aggiungere fino a 50 contenitori alla volta; l'individuazione elenca fino a 300 contenitori nell'account di archiviazione.
Ricollegando in seguito lo stesso account di archiviazione, puoi aggiungere nuovi contenitori all'integrazione esistente. Una credenziale salvata viene sostituita solo se quella nuova può continuare a leggere tutti i contenitori già collegati. Se non è possibile leggere un contenitore, il messaggio di errore ne indica il nome, inclusi i contenitori collegati in precedenza con lo stesso account di archiviazione.
Se esposta al di fuori di Platform, una chiave dell'account può autorizzare operazioni di scrittura ed eliminazione o creare token SAS. Le credenziali sono cifrate a riposo con AES-256-GCM, non vengono mai restituite al browser né esposte ai carichi di lavoro di addestramento. Quando possibile, usa un account di archiviazione dedicato. Per revocare l'accesso, rinnova le chiavi di accesso dell'account di archiviazione in Azure.
Crea un dataset da un contenitore Blob#
- Fai clic su New Dataset e apri la scheda Cloud.
- Scegli un contenitore collegato e individua la cartella che contiene i tuoi dati.
- Conferma la cartella, modifica il nome del dataset e crealo.
Platform elenca la cartella una volta e indicizza gli elementi trovati:
- Immagini — I blob
.jpg,.jpeg,.png,.webpe.avifvengono indicizzati; le dimensioni vengono lette tramite richieste limitate. Platform non conserva una seconda copia dell'immagine sorgente. - Etichette — i file associati YOLO
.txtvengono analizzati e convertiti in annotazioni Platform, abbinate usando la struttura standardimages/→labels/o come elementi adiacenti nella stessa cartella. - Metadati — un file YAML fornisce i nomi delle classi e la struttura dei punti chiave della posa, proprio come un caricamento di archivio. Se la cartella ne contiene diversi, vengono preferiti
data.yamledata.yml. - Attività — l'attività viene determinata da un campione dei file di etichette, quindi le cartelle di segmentazione, posa e OBB vengono riconosciute in base alla struttura delle etichette, non all'attività scelta nella finestra di dialogo.
- Suddivisioni — I nomi delle cartelle
train,valetestnel percorso del blob assegnano automaticamente le suddivisioni.
Il dataset funziona quindi come qualsiasi altro: puoi sfogliarlo e annotarlo, renderlo pubblico o privato, condividerlo con il tuo team e addestrare modelli usando l'addestramento gestito. Gli originali vengono trasmessi su richiesta e le immagini indicizzate non consumano la quota di spazio di archiviazione di Platform.
Una singola importazione indicizza fino a 500.000 blob e file di etichette o YAML fino a 1 MB ciascuno. I contenitori più grandi vanno suddivisi in più dataset.
Ogni immagine indicizzata è associata all'ETag del relativo blob e Platform blocca l'accesso in caso di modifiche al blob. Aggiungi nuovi blob invece di sovrascrivere quelli esistenti.
Importazioni non riuscite#
Se un'importazione non riesce — per una cartella vuota, un errore di battitura nel percorso o permessi revocati — il dataset mostra l'errore nella propria pagina. Gli editor possono fare clic su Riprova importazione per riavviarla usando il contenitore e la cartella salvati, oppure creare un nuovo dataset che punti al percorso corretto.
Un nuovo tentativo elenca nuovamente la cartella invece di riprendere da dove si era interrotto: i blob aggiunti dopo il primo tentativo vengono inclusi, mentre quelli che non sono più presenti vengono rimossi dal dataset.
Addestramento#
L'addestramento gestito segue il normale flusso di addestramento. Durante l'esecuzione, l'addestramento usa le copie delle immagini bloccate create da Platform, e le tue credenziali Azure non vengono mai esposte ai carichi di lavoro di addestramento.
Disconnetti una connessione#
La disconnessione elimina la stringa di connessione salvata senza modificare nulla in Azure. I dataset creati a partire da questi contenitori rimangono nel tuo workspace con le relative classi, etichette e annotazioni, ma le immagini non possono essere caricate, visualizzate in anteprima o usate per l'addestramento finché non viene riconnesso lo stesso account di archiviazione. Anche mentre sono disconnessi, puoi rinominare i dataset, modificare le etichette o eliminarli.
Per disconnettere, vai a Impostazioni > Integrazioni, seleziona Azure Blob Storage, fai clic su Disconnetti accanto alla credenziale e conferma. Quando apri uno dei dataset associati, viene mostrato Azure Blob Storage disconnesso con un link a queste impostazioni; il dataset torna disponibile automaticamente una volta effettuata la riconnessione.
Puoi anche disconnetterti tramite la REST API, usando l'ID dell'integrazione restituito da GET /api/integrations/buckets:
curl -X DELETE \
-H "Authorization: Bearer YOUR_API_KEY" \
https://platform.ultralytics.com/api/integrations/buckets/INTEGRATION_IDfrom ultralytics_platform import Platform
client = Platform() # reads ULTRALYTICS_API_KEY
integrations = client.storage_integrations.list()
client.storage_integrations.delete("INTEGRATION_ID")Per revocare l'accesso direttamente alla fonte, rinnova le chiavi di accesso dell'account di archiviazione in Azure.
Limitazioni attuali#
I dataset collegati ad Azure al momento non supportano le funzionalità che richiedono copie delle immagini gestite da Platform: annotazione automatica, analisi dei cluster, clonazione dei dataset e istantanee di versione immutabili.
L'eliminazione di un dataset basato su Azure, o di singole immagini al suo interno, rimuove solo i riferimenti di Platform: i tuoi blob non vengono mai modificati.
Vedi anche le integrazioni Google Cloud Storage e Amazon S3.
Domande frequenti#
No. Platform elenca il container una sola volta e indicizza le dimensioni delle immagini e le etichette che trova. Gli originali vengono trasmessi su richiesta per la consultazione e l'annotazione; l'addestramento gestito utilizza copie realizzate da Platform delle sole immagini fissate per la durata dell'esecuzione. Le immagini indicizzate non vengono conteggiate nella tua quota di archiviazione.
Un dataset viene indicizzato una sola volta, al momento della creazione. I nuovi oggetti non vengono acquisiti finché non crei un nuovo dataset o riprovi un'importazione non riuscita; inoltre, ogni immagine indicizzata è associata alla propria versione, quindi la sovrascrittura di un oggetto fa sì che Platform blocchi l'accesso a quell'immagine. Aggiungi nuovi oggetti invece di sostituire quelli esistenti.
Disconnetti l'integrazione in Impostazioni > Integrazioni per eliminare le credenziali salvate, oppure ruota le chiavi di accesso dell'account di archiviazione in Azure. Nessuna delle due operazioni interviene sui dati nei tuoi container.