AzureBlobDatastore Classe

Représente un magasin de données qui enregistre les informations de connexion dans Stockage Blob Azure.

Il est déconseillé d’utiliser cette classe directement. Pour créer une banque de banques de ce type, utilisez la méthode register_azure_blob_container du magasin de données.

Remarque : quand vous utilisez un magasin de données pour accéder aux données, vous devez être autorisé à accéder à ces données. Cela dépend des informations d’identification inscrites auprès du magasin de données.

Initialisez un nouveau magasin de données Blob Azure.

Héritage

AbstractAzureStorageDatastore

AzureBlobDatastore

Constructeur

AzureBlobDatastore(workspace, name, container_name, account_name, sas_token=None, account_key=None, protocol=None, endpoint=None, request_session=None, workspace_msi_has_access=False, subscription_id=None, resource_group=None, service_data_access_auth_identity=None)

Paramètres

workspace

Workspace

Obligatoire

Espace de travail auquel ce magasin de données appartient.

name

str

Obligatoire

Nom du magasin de données. Cette valeur peut contenir uniquement des caractères alphanumériques, ainsi que - ou _.

container_name

str

Obligatoire

Nom du conteneur d’objets blob.

account_name

str

Obligatoire

nom du compte de stockage.

sas_token

str, <xref:optional>

valeur par défaut: None

Jeton SAS pour accéder à ce conteneur. La valeur par défaut est None.

account_key

str, <xref:optional>

valeur par défaut: None

La clé du compte de stockage. La valeur par défaut est None.

protocol

str, <xref:optional>

valeur par défaut: None

Protocole à utiliser pour la connexion au compte de stockage. Si None est défini, la valeur par défaut est https.

endpoint

str, <xref:optional>

valeur par défaut: None

Point de terminaison du conteneur d’objets blob. Si None est défini, la valeur par défaut est core.windows.net.

request_session

<xref:requests.Session>, <xref:optional>

valeur par défaut: None

Objet de session à utiliser pour les requêtes http. La valeur par défaut est None.

workspace

Workspace

Obligatoire

Espace de travail auquel ce magasin de données appartient.

name

str

Obligatoire

Nom du magasin de données. Cette valeur peut contenir uniquement des caractères alphanumériques, ainsi que - ou _.

container_name

str

Obligatoire

Nom du conteneur d’objets blob.

account_name

str

Obligatoire

nom du compte de stockage.

sas_token

str, <xref:optional>

Obligatoire

Jeton SAS pour accéder à ce conteneur. La valeur par défaut est None.

account_key

str, <xref:optional>

Obligatoire

La clé du compte de stockage. La valeur par défaut est None.

protocol

str, <xref:optional>

Obligatoire

Protocole à utiliser pour la connexion au compte de stockage. Si None est défini, la valeur par défaut est https.

endpoint

str, <xref:optional>

Obligatoire

Point de terminaison du conteneur d’objets blob. Si None est défini, la valeur par défaut est core.windows.net.

request_session

<xref:requests.Session>, <xref:optional>

Obligatoire

Objet de session à utiliser pour les requêtes http. La valeur par défaut est None.

workspace_msi_has_access

bool, <xref:optional>

valeur par défaut: False

Indique si l’msi de l’espace de travail a accès à ce compte de stockage. (Déconseillé)

subscription_id

str, <xref:optional>

valeur par défaut: None

ID d’abonnement du compte de stockage.

resource_group

str, <xref:optional>

valeur par défaut: None

Groupe de ressources du compte de stockage.

service_data_access_auth_identity

str ou <xref:_restclient.models.ServiceDataAccessAuthIdentity>

valeur par défaut: None

Indique l’identité à utiliser pour authentifier l’accès aux données de service au stockage du client. Les valeurs possibles sont notamment : « None », « WorkspaceSystemAssignedIdentity », « WorkspaceUserAssignedIdentity »

Méthodes

download	Télécharge les données du conteneur d’objets blob dans le système de fichiers local.
upload	Charge les données du système de fichiers local vers le conteneur d’objets blob vers lequel pointe ce magasin de données. Remarque : pour que cette méthode fonctionne, la propriété de clé de compte ou du jeton SAS doit être remplie dans l’objet du magasin de données. Si l’objet du magasin de données ne contient aucune forme d’informations d’identification, cette méthode échoue. En outre, cette méthode est déconseillée et peut être supprimée à l’avenir. Nous recommandons d’utiliser la méthode Dataset.File.upload_directory pour charger vos fichiers à partir du répertoire local et de créer FileDataset dans un appel de méthode unique.
upload_files	Charge les données du système de fichiers local vers le conteneur d’objets blob vers lequel pointe ce magasin de données. Remarque : cette méthode est déconseillée et ne sera plus prise en charge à l’avenir. Il est recommandé d’utiliser FileDatasetFactory.upload_directory à la place.

download

Télécharge les données du conteneur d’objets blob dans le système de fichiers local.

download(target_path, prefix=None, overwrite=False, show_progress=True)

Paramètres

target_path

str

Obligatoire

Répertoire local dans lequel télécharger le fichier.

prefix

str, <xref:optional>

valeur par défaut: None

Chemin d’accès au dossier dans le conteneur d’objets blob où effectuer le téléchargement. Si None est défini, télécharge tous les éléments dans l’objet blob. La valeur par défaut est None.

overwrite

bool, <xref:optional>

valeur par défaut: False

Indique si les fichiers existants doivent être remplacés. Valeur par défaut False.

show_progress

bool, <xref:optional>

valeur par défaut: True

Indique si la progression du téléchargement doit s’afficher dans la console. La valeur par défaut est True.

Retours

Nombre de fichiers téléchargés.

Type de retour

int

upload

Charge les données du système de fichiers local vers le conteneur d’objets blob vers lequel pointe ce magasin de données.

Remarque : pour que cette méthode fonctionne, la propriété de clé de compte ou du jeton SAS doit être remplie dans l’objet du magasin de données. Si l’objet du magasin de données ne contient aucune forme d’informations d’identification, cette méthode échoue. En outre, cette méthode est déconseillée et peut être supprimée à l’avenir. Nous recommandons d’utiliser la méthode Dataset.File.upload_directory pour charger vos fichiers à partir du répertoire local et de créer FileDataset dans un appel de méthode unique.

upload(src_dir, target_path=None, overwrite=False, show_progress=True)

Paramètres

src_dir

str

Obligatoire

Répertoire local à charger.

target_path

str

Obligatoire

Emplacement dans le conteneur d’objets blob vers lequel effectuer le chargement. Si None est défini, charge vers la racine. La valeur par défaut est None.

overwrite

bool, <xref:optional>

Obligatoire

Indique si les fichiers existants doivent être remplacés. Valeur par défaut False.

show_progress

bool, <xref:optional>

Obligatoire

Indique si la progression du chargement doit s’afficher dans la console. La valeur par défaut est True.

Retours

Instance DataReference pour le chemin d’accès cible chargé.

Type de retour

DataReference

upload_files

Charge les données du système de fichiers local vers le conteneur d’objets blob vers lequel pointe ce magasin de données.

Remarque : cette méthode est déconseillée et ne sera plus prise en charge à l’avenir. Il est recommandé d’utiliser FileDatasetFactory.upload_directory à la place.

upload_files(files, relative_root=None, target_path=None, overwrite=False, show_progress=True)

Paramètres

files

list[str]

Obligatoire

Liste des chemins d’accès absolus aux fichiers à charger.

relative_root

str, <xref:optional>

Obligatoire

Racine utilisée pour déterminer le chemin d’accès aux fichiers dans l’objet blob. Par exemple, si nous chargeons /path/to/file.txt et que nous définissons le chemin de base comme étant /path, quand file.txt est chargé sur le Stockage Blob, le chemin est /to/file.txt. Si target_path est également indiqué, il est utilisé comme préfixe pour le chemin dérivé ci-dessus. Le chemin d’accès de base doit être un chemin d’accès commun à tous les fichiers. Dans le cas contraire, une exception est levée. La valeur par défaut est None, ce qui permet de trouver le chemin d’accès commun.

target_path

str, <xref:optional>

Obligatoire

Emplacement dans le conteneur d’objets blob où charger les données. La valeur par défaut est None, la racine.

overwrite

bool, <xref:optional>

Obligatoire

Indique si les fichiers existants doivent être remplacés. Valeur par défaut False.

show_progress

bool, <xref:optional>

Obligatoire

Indique si la progression du chargement doit s’afficher dans la console. La valeur par défaut est True.

Retours

Instance DataReference pour le chemin d’accès cible chargé.

Type de retour

DataReference