Abfragen von Daten mithilfe von MATLAB

Artikel
11/23/2024

MATLAB ist eine Programmier- und Numerische Computerplattform, die verwendet wird, um Daten zu analysieren, Algorithmen zu entwickeln und Modelle zu erstellen. In diesem Artikel wird erläutert, wie Sie ein Autorisierungstoken in TOKENS für Azure Data Explorer abrufen und wie Sie das Token für die Interaktion mit Ihrem Cluster verwenden.

Voraussetzungen

Wählen Sie die Registerkarte für das Betriebssystem aus, das zum Ausführen von ASPX verwendet wird.

Windows-Betriebssystem
Linux

Laden Sie die Microsoft Identity Client - und die Microsoft Identity Abstractions-Pakete von NuGet herunter.
Extrahieren Sie die heruntergeladenen Pakete und DLL-Dateien aus lib\net45 in einen Ordner der Wahl. In diesem Artikel verwenden wir den Ordner "C:\Ister\DLL".

Installieren Sie JDK 8 und Maven.

Klonen Sie das INTERFACES Interface für das Azure Services-Repository :

git clone https://github.com/mathworks-ref-arch/matlab-azure-services.git

Erstellen Sie das AZURE SDK JAR DES SDK:
```
cd matlab-azure-services/Software/Java
mvn clean package
```
Der Build sollte die Datei erzeugen: Software/MATLAB/lib/jar/azure-common-sdk-0.2.0.jar.
Laden Sie die JAR-Datei im STUDIO UND fügen Sie sie dem java-statischen Klassenpfad hinzu:
```
edit(fullfile(prefdir,'javaclasspath.txt'));
```
Fügen Sie in der Java-Datei für statische Klassenpfade einen Eintrag hinzu, der der Jar-Datei entspricht:
```
(full-path)/matlab-azure-services/Software/MATLAB/lib/jar/azure-common-sdk-0.2.0.jar
```

Starten Sie die GPU-IDE neu. Führen Sie nach dem erneuten Laden das skript startup.m aus, das unter scripts-azure-services\Software\SCRIPTS\startup.m verfügbar ist. Dadurch wird sichergestellt, dass alle erforderlichen Funktionen für den Zugriff auf Azure-Dienste eingerichtet sind. Die Ausgabe sollte wie folgt aussehen:

>> startup
Adding Azure Paths
------------------
Adding: matlab-azure-services/Software/MATLAB/app
Adding: matlab-azure-services/Software/MATLAB/app/functions
Adding: matlab-azure-services/Software/MATLAB/app/system
Adding: matlab-azure-services/Software/MATLAB/lib
Adding: matlab-azure-services/Software/MATLAB/config
Skipping: matlab-azure-services/Software/Utilities
Checking the static Java classpath for: matlab-azure-services/Software/MATLAB/lib/jar/azure-common-sdk-0.2.0.jar
Found: azure-common-sdk-0.2.0.jar

Durchführen der Benutzerauthentifizierung

Bei der Benutzerauthentifizierung wird der Benutzer aufgefordert, sich über ein Browserfenster anzumelden. Bei erfolgreicher Anmeldung wird ein Benutzerautorisierungstoken gewährt. In diesem Abschnitt wird gezeigt, wie Sie diesen interaktiven Anmeldefluss konfigurieren.

So führen Sie die Benutzerauthentifizierung aus:

Windows-Betriebssystem
Linux

Definieren Sie die konstanten, die für die Autorisierung erforderlich sind. Weitere Informationen zu diesen Werten finden Sie unter Authentifizierungsparameter.

% The Azure Data Explorer cluster URL
clusterUrl = 'https://<adx-cluster>.kusto.windows.net';
% The Azure AD tenant ID
tenantId = '';
% Send a request to https://<adx-cluster>.kusto.windows.net/v1/rest/auth/metadata
% The appId should be the value of KustoClientAppId
appId = '';
% The Azure AD scopes
scopesToUse = strcat(clusterUrl,'/.default ');

Laden Sie im STUDIOS die extrahierten DLL-Dateien:

% Access the folder that contains the DLL files
dllFolder = fullfile("C:","Matlab","DLL");

% Load the referenced assemblies in the MATLAB session
matlabDllFiles = dir(fullfile(dllFolder,'*.dll'));
for k = 1:length(matlabDllFiles)
    baseFileName = matlabDllFiles(k).name;
    fullFileName = fullfile(dllFolder,baseFileName);
    fprintf(1, 'Reading  %s\n', fullFileName);
end
    % Load the downloaded assembly in MATLAB
    NET.addAssembly(fullFileName);

Verwenden Sie den PublicClientApplicationBuilder , um eine interaktive Benutzeranmeldung aufzufordern:

% Create an PublicClientApplicationBuilder
app = Microsoft.Identity.Client.PublicClientApplicationBuilder.Create(appId)...
    .WithAuthority(Microsoft.Identity.Client.AzureCloudInstance.AzurePublic,tenantId)...
    .WithRedirectUri('http://localhost:8675')...
    .Build();

% System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;
NET.setStaticProperty ('System.Net.ServicePointManager.SecurityProtocol',System.Net.SecurityProtocolType.Tls12)
% Start with creating a list of scopes
scopes = NET.createGeneric('System.Collections.Generic.List',{'System.String'});
% Add the actual scopes
scopes.Add(scopesToUse);
fprintf(1, 'Using appScope  %s\n', scopesToUse);

% Get the token from the service
% and show the interactive dialog in which the user can login
tokenAcquirer = app.AcquireTokenInteractive(scopes);
result = tokenAcquirer.ExecuteAsync;

% Extract the token and when it expires
% and retrieve the returned token
token = char(result.Result.AccessToken);
fprintf(2, 'User token aquired and will expire at %s & extended expires at %s', result.Result.ExpiresOn.LocalDateTime.ToString,result.Result.ExtendedExpiresOn.ToLocalTime.ToString);

Verwenden Sie das Autorisierungstoken, um Ihren Cluster über die REST-API abzufragen:

options=weboptions('HeaderFields',{'RequestMethod','POST';'Accept' 'application/json';'Authorization' ['Bearer ', token]; 'Content-Type' 'application/json; charset=utf-8'; 'Connection' 'Keep-Alive'; 'x-ms-app' 'Matlab'; 'x-ms-client-request-id' 'Matlab-Query-Request'});

% The DB and KQL variables represent the database and query to execute
querydata = struct('db', "<DB>", 'csl', "<KQL>");
querryresults  = webwrite("https://sdktestcluster.westeurope.dev.kusto.windows.net/v2/rest/query", querydata, options);

% Extract the results row
results=querryresults{3}.Rows

Erstellen Sie eine Auth.json Datei in Ihrem Arbeitsverzeichnis mit den relevanten Anmeldeinformationen. Die kustoClientAppId, von https://<adx-cluster>.kusto.windows.net/v1/rest/auth/metadata der zurückgegeben wird, muss durch den Wert von "ClientId" ersetzt werden:
```
{
    "AuthMethod": "InteractiveBrowser",
    "TenantId" : "<AAD Tenant / Authority ID for the login>",
    "ClientId" : "<Client ID>",
    "RedirectUrl": "http://localhost:8675"
}
```

Fragen Sie Ihren Cluster wie folgt ab:

% References the credential file created in the previous step
credentials = configureCredentials('Auth.json');

% Point the scopes to the Azure Data Explorer cluster that we want to query
request = azure.core.credential.TokenRequestContext();
request.addScopes('<https://adx-cluster-changeme.kusto.windows.net/.default>');
token=credentials.getToken(request);

% Prepare to query the cluster
options=weboptions('HeaderFields',{'RequestMethod','POST';'Accept' 'application/json';'Authorization' ['Bearer ', token.getToken()]; 'Content-Type' 'application/json; charset=utf-8'; 'Connection' 'Keep-Alive'; 'x-ms-app' 'Matlab'; 'x-ms-client-request-id' 'Matlab-Query-Request'});

% The DB and KQL variables represent the database and query to execute
querydata = struct('db', "<DB>", 'csl', "<KQL>");
querryresults  = webwrite('<https://adx-cluster-changeme.kusto.windows.net/v2/rest/query>', querydata, options);

% The results row can be extracted as follows
results=querryresults{3}.Rows

Durchführen der Anwendungsauthentifizierung

Die Microsoft Entra-Anwendungsautorisierung kann für Szenarien verwendet werden, in denen die interaktive Anmeldung nicht erwünscht ist und automatisierte Ausführung erforderlich ist.

So führen Sie die Anwendungsauthentifizierung aus:

Windows-Betriebssystem
Linux

Stellen Sie eine Microsoft Entra-Anwendung bereit. Wählen Sie für den Umleitungs-URI Web und Eingabe http://localhost:8675 als URI aus.

Definieren Sie die konstanten, die für die Autorisierung erforderlich sind. Weitere Informationen zu diesen Werten finden Sie unter Authentifizierungsparameter.

% The Azure Data Explorer cluster URL
clusterUrl = 'https://<adx-cluster>.kusto.windows.net';
% The Azure AD tenant ID
tenantId = '';
% The Azure AD application ID and key
appId = '';
appSecret = '';

Laden Sie im STUDIOS die extrahierten DLL-Dateien:

 % Access the folder that contains the DLL files
 dllFolder = fullfile("C:","Matlab","DLL");

 % Load the referenced assemblies in the MATLAB session
 matlabDllFiles = dir(fullfile(dllFolder,'*.dll'));
 for k = 1:length(matlabDllFiles)
     baseFileName = matlabDllFiles(k).name;
     fullFileName = fullfile(dllFolder,baseFileName);
     fprintf(1, 'Reading  %s\n', fullFileName);
 end
     % Load the downloaded assembly
     NET.addAssembly(fullFileName);

Verwenden Sie " ConfidentialClientApplicationBuilder ", um eine nicht interaktive automatisierte Anmeldung mit der Microsoft Entra-Anwendung durchzuführen:

%  Create an ConfidentialClientApplicationBuilder
app = Microsoft.Identity.Client.ConfidentialClientApplicationBuilder.Create(appId)...
    .WithAuthority(Microsoft.Identity.Client.AzureCloudInstance.AzurePublic,tenantId)...
    .WithRedirectUri('http://localhost:8675')...
    .WithClientSecret(appSecret)...
    .Build();

% System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;
NET.setStaticProperty ('System.Net.ServicePointManager.SecurityProtocol',System.Net.SecurityProtocolType.Tls12)
% Start with creating a list of scopes
scopes = NET.createGeneric('System.Collections.Generic.List',{'System.String'});
% Add the actual scopes
scopes.Add(scopesToUse);
fprintf(1, 'Using appScope  %s\n', scopesToUse);

% Get the token from the service and cache it until it expires
tokenAcquirer = app.AcquireTokenForClient(scopes);
result = tokenAcquirer.ExecuteAsync;

% Extract the token and when it expires
% retrieve the returned token
token = char(result.Result.AccessToken);
fprintf(2, 'User token aquired and will expire at %s & extended expires at %s', result.Result.ExpiresOn.LocalDateTime.ToString,result.Result.ExtendedExpiresOn.ToLocalTime.ToString);

Verwenden Sie das Autorisierungstoken, um Ihren Cluster über die REST-API abzufragen:

options=weboptions('HeaderFields',{'RequestMethod','POST';'Accept' 'application/json';'Authorization' ['Bearer ', token]; 'Content-Type' 'application/json; charset=utf-8'; 'Connection' 'Keep-Alive'; 'x-ms-app' 'Matlab'; 'x-ms-client-request-id' 'Matlab-Query-Request'});

% The DB and KQL variables represent the database and query to execute
querydata = struct('db', "<DB>", 'csl', "<KQL>");
querryresults  = webwrite("https://sdktestcluster.westeurope.dev.kusto.windows.net/v2/rest/query", querydata, options);

% Extract the results row
results=querryresults{3}.Rows

Erstellen Sie eine Auth.json Datei in Ihrem Arbeitsverzeichnis mit den relevanten Anmeldeinformationen:

{
    "AuthMethod": "ClientSecret",
    "TenantId" : "<AAD Tenant / Authority ID for the login>",
    "ClientId" : "<Client ID of the Azure AD application>",
    "ClientSecret": "<Client Key of the Azure AD application>",
    "RedirectUrl": "http://localhost:8675"
}

Fragen Sie Ihren Cluster wie folgt ab:

% References the credential file created in the previous step
credentials = configureCredentials('Auth.json');

% Point the scopes to the Azure Data Explorer cluster that we want to query
request = azure.core.credential.TokenRequestContext();request.addScopes('<https://adx-cluster-changeme.kusto.windows.net/.default>');
token=credentials.getToken(request);

% Prepare to query the cluster
options=weboptions('HeaderFields',{'RequestMethod','POST';'Accept' 'application/json';'Authorization' ['Bearer ', token.getToken()]; 'Content-Type' 'application/json; charset=utf-8'; 'Connection' 'Keep-Alive'; 'x-ms-app' 'Matlab'; 'x-ms-client-request-id' 'Matlab-Query-Request'});

% The DB and KQL variables represent the database and query to execute
querydata = struct('db', "<DB>", 'csl', "<KQL>");
querryresults  = webwrite('<https://adx-cluster-changeme.kusto.windows.net/v2/rest/query>', querydata, options);

% The results row can be extracted as follows
results=querryresults{3}.Rows

Abfragen ihres Clusters mit der REST-API

Freigeben über

Abfragen von Daten mithilfe von MATLAB

Voraussetzungen

Durchführen der Benutzerauthentifizierung

Durchführen der Anwendungsauthentifizierung

Feedback

Zusätzliche Ressourcen

Freigeben über

Abfragen von Daten mithilfe von MATLAB

Voraussetzungen

Durchführen der Benutzerauthentifizierung

Durchführen der Anwendungsauthentifizierung

Zugehöriger Inhalt

Feedback

Zusätzliche Ressourcen