Link to this sectionAzure Blob Storage連携#

Azure Blob Storage連携により、お使いのストレージアカウントコンテナを Ultralytics Platform に接続できます。画像はコンテナ内に保持されたまま、Platformがその場でインデックスを作成するため、コピーをアップロードすることなく、YOLOモデルの閲覧、アノテーション、トレーニングが可能です。

Pro 機能

Azure Blob Storageデータセットには ProまたはEnterpriseプラン が必要です。無料ワークスペースでも連携機能は表示されますが、接続時にアップグレードが求められます。既存のAzure Blob Storageデータセットは、サブスクリプションが終了しても完全にアクセス可能な状態が維持されます。Proプランが必要になるのは、新しい接続とインポートを行う場合のみです。

Link to this section接続文字列の取得#

Platformはストレージから読み取りのみを行い、Blobの書き込み、変更、削除は一切行いません。現在の連携機能では、アカウントアクセスキーの接続文字列が必要です。これによりアカウント全体の権限が付与されますが、Platformが使用するのはリスト表示と読み取り操作のみです：

1. Azureポータルで、ストレージアカウントを開きます。
2. セキュリティとネットワーク > アクセスキー に移動します。
3. 接続文字列 をコピーします。

パブリックAzureクラウドのみ

接続には標準の blob.core.windows.net エンドポイントを使用します。ソブリンクラウド（Azure China、Azure Government）およびカスタムBlobエンドポイントはサポートされていません。

Link to this sectionPlatform への接続#

1. 設定 > 連携 に移動し、Microsoft Azure カードを見つけます。
2. 接続 をクリックし、接続文字列を貼り付けます。
3. Platformがストレージアカウント内のコンテナをリスト表示します。接続するコンテナを選択するか、手動でコンテナ名を入力してください。
4. 接続 をクリックします。Platformは、保存前に各選択コンテナのリスト表示と読み取りが可能であることを検証します。

後で同じストレージアカウントを再接続すると、既存の連携に新しいコンテナが追加されます。保存された認証情報は、置換後の認証情報でも既に接続済みのすべてのコンテナを読み取れることが確認できた場合にのみ更新されます。

資格情報のセキュリティ

アカウントキーがPlatformの外部で公開された場合、書き込みや削除操作、あるいはSASトークンの作成を許可する恐れがあります。認証情報はAES-256-GCMで保存時に暗号化され、ブラウザに返されることはなく、トレーニングジョブのペイロードに含まれることもありません。可能であれば、専用のストレージアカウントを使用してください。アクセスを取り消すには、Azureでストレージアカウントのアクセスキーをローテーションしてください。

Link to this sectionBlobコンテナからデータセットを作成#

1. 新しいデータセット をクリックし、クラウドストレージ タブを開きます。
2. 接続済みのコンテナを選択し、データが含まれるフォルダーを参照します。
3. フォルダーを確認し、データセット名を調整して、データセットを作成します。

Platform がフォルダーを一度リスト表示し、見つかった内容をインデックス化します：

• 画像 — .jpg、.jpeg、.png、.webp、.avif のBlobは、制限付きヘッダーリクエストから読み取られた寸法情報とともにインデックス化されます。元のピクセルデータがコンテナからコピーされることはありません。
• ラベル — YOLO .txt サイドカーファイルは Platform のアノテーションに解析されます。標準の images/ → labels/ レイアウト、または同じフォルダー内の関連ファイルとして照合されます。
• メタデータ — data.yaml/data.yml は、アーカイブアップロード と同様に、クラス名、タスクタイプ、ポーズキーポイントの形状を提供します。
• 分割 — Blobパス内の train、val、test というフォルダー名により、データセットの分割が自動的に割り当てられます。

データセットはその後、他のデータセットと同様に機能します。閲覧や アノテーション、公開・非公開の設定、チームとの共有、管理された学習による 学習 が可能です。オリジナル画像はオンデマンドでストリーミングされ、インデックス化された画像は Platform の ストレージクォータ を消費しません。

制限事項

1回のインポートで最大50,000個のBlob、ラベルまたはYAMLファイルはそれぞれ最大1MBまでインデックス化可能です。これを超える大規模なコンテナは、複数のデータセットに分割してください。

インデックス化されたBlobを不変に保つ

インデックス化されたすべての画像は、そのBlobのETagに固定されます。Blobが背後で変更された場合、Platformはエラーを発生させて処理を停止します。既存のBlobを上書きするのではなく、新しいBlobを追加してください。

Link to this sectionインポートの失敗#

空のフォルダー、パスのタイプミス、権限の取り消しなどでインポートが失敗した場合、データセットページにエラーが表示されます。編集者は インポートを再試行 をクリックして保存されたコンテナとフォルダーでやり直すか、正しいパスを指す新しいデータセットを作成できます。

Link to this sectionトレーニング#

マネージドトレーニングは、通常のトレーニングフローを通じて実行されます。ワーカーは、実行のために固定されたオリジナルのデータを一時的なジョブストレージにダウンロードし、ジョブの完了時に削除します。Azureの認証情報がコンピュート環境に渡されることはありません。

Link to this section現在の制限事項#

Azureベースのデータセットでは現在、Platformが保有する画像のコピーを必要とする機能（自動アノテーション、クラスタリング分析、データセットの複製、不変な バージョンスナップショット）は利用できません。

Azureベースのデータセットや個別の画像を削除しても、Platform側の参照が削除されるだけであり、実際のBlobデータに影響を与えることはありません。

Google Cloud Storage および Amazon S3 の連携機能も併せてご覧ください。