Intégrer des données externes

  • 5 minutes

L’opérateur externaldata retourne une table dont le schéma est défini dans la requête elle-même. et dont les données sont lues à partir d’un artefact de stockage externe, tel qu’un objet blob dans le stockage Blob Azure ou un fichier Azure Data Lake Storage.

Syntaxe

 externaldata ( ColumnName : ColumnType [, ...] )
  [ StorageConnectionString [, ...] ]
  [with ( PropertyName = PropertyValue [, ...] )]

Arguments

  • ColumnName, ColumnType : les arguments définissent le schéma de la table. La syntaxe est la même que celle utilisée pour définir une table dans .create table.

  • StorageConnectionString : chaînes de connexion de stockage qui décrivent les artefacts de stockage contenant les données à retourner.

  • PropertyName, PropertyValue, ... : propriétés supplémentaires qui décrivent comment interpréter les données récupérées à partir du stockage, comme indiqué sous propriétés d’ingestion.

Actuellement, les propriétés prises en charge sont les suivantes :

ARGUMENTS

Propriété Type Description
format string Format de données. S’il n’est pas spécifié, une tentative est faite pour détecter le format de données à partir de l’extension de fichier (CSV par défaut). Les formats de données d’ingestion sont pris en charge.
ignoreFirstRecord bool Si la valeur est définie sur « true », cela indique que le premier enregistrement de chaque fichier est ignoré. Cette propriété est utile lors de l’interrogation de fichiers CSV avec des en-têtes.
ingestionMapping string Valeur de chaîne qui indique comment mapper les données du fichier source aux colonnes réelles dans l'ensemble des résultats de l'opérateur. Consultez mappages de données.

Retours

L’opérateur « externaldata » retourne une table de données du schéma donné avec les données analysées à partir de l’artefact de stockage spécifié, indiqué par la chaîne de connexion de stockage.

Notes

Cet exemple n’est pas disponible dans l’environnement de démonstration.

Users
| where UserID in ((externaldata (UserID:string) [
    @"https://storageaccount.blob.core.windows.net/storagecontainer/users.txt" 
      h@"?...SAS..." // Secret token needed to access the blob
    ]))
| ...