Wichtig
Diese Seite enthält Anweisungen zum Verwalten von Azure IoT Operations-Komponenten mithilfe von Kubernetes-Bereitstellungsmanifesten, die sich in DER VORSCHAU befinden. Dieses Feature ist mit mehreren Einschränkungen versehen und sollte nicht für Produktionsworkloads verwendet werden.
Lesen Sie die ergänzenden Nutzungsbedingungen für Microsoft Azure Previews für rechtliche Bestimmungen, die für Azure-Features gelten, die sich in Der Betaversion, Vorschau oder auf andere Weise noch nicht in der allgemeinen Verfügbarkeit befinden.
Um Daten in Azure IoT Einsatz an Microsoft Fabric OneLake zu senden, können Sie einen Datenflussendpunkt konfigurieren. Mit dieser Konfiguration können Sie den Zielendpunkt, die Authentifizierungsmethode, die Tabelle und andere Einstellungen angeben.
Voraussetzungen
Zuweisen von Berechtigungen zur verwalteten Identität
Um einen Datenflussendpunkt für Microsoft Fabric OneLake zu konfigurieren, wird empfohlen, eine benutzendenseitig zugewiesene oder eine systemseitig zugewiesene verwaltete Identität zu verwenden. Dieser Ansatz ist sicher und beseitigt die Notwendigkeit der manuellen Verwaltung von Anmeldeinformationen.
Nachdem Microsoft Fabric OneLake erstellt wurde, müssen Sie der verwalteten Azure IoT Einsatz-Identität eine Rolle zuweisen, die die Berechtigung zum Schreiben in das Fabric Lakehouse gewährt.
Wenn Sie die vom System zugewiesene verwaltete Identität verwenden, wechseln Sie im Azure-Portal zu Ihrer Azure IoT Operations-Instanz, und wählen Sie "Übersicht" aus. Kopieren Sie den Namen der Erweiterung, die nach der Azure IoT Operations Arc-Erweiterung aufgeführt ist. Beispiel: azure-iot-operations-xxxx7. Ihre systemseitig zugewiesene verwaltete Identität hat denselben Namen wie die Arc-Erweiterung von Azure IoT Einsatz.
Wechseln Sie zum von Ihnen erstellten Microsoft Fabric-Arbeitsbereich, wählen Sie "Zugriff verwalten> oder Gruppen hinzufügen" aus.
- Suchen Sie nach dem Namen Ihrer vom Benutzer zugewiesenen verwalteten Identität, die für Cloudverbindungen oder die vom System zugewiesene verwaltete Identität eingerichtet ist. Beispiel: azure-iot-operations-xxxx7.
- Wählen Sie "Mitwirkender " als Rolle und dann "Hinzufügen" aus. Dadurch erhält die verwaltete Identität die erforderlichen Berechtigungen zum Schreiben in das Fabric Lakehouse. Weitere Informationen finden Sie unter Rollen in Arbeitsbereichen in Microsoft Fabric.
Erstellen eines Datenflussendpunkts für Microsoft Fabric OneLake
Wählen Sie in der Betriebsumgebung die Registerkarte "Datenflussendpunkte" aus .
Wählen Sie unter "Neuen Datenflussendpunkt erstellen" die Option "Microsoft Fabric OneLake>New" aus.
Geben Sie die folgenden Einstellungen für den Endpunkt ein:
| Einstellung |
Beschreibung |
| Gastgeber |
Der Hostname des Microsoft Fabric OneLake-Endpunkts im Format onelake.dfs.fabric.microsoft.com. |
| Lakehouse-Name |
Der Name des Lakehouse, in dem die Daten gespeichert werden sollen. |
| Arbeitsbereichsname |
Der Name des Arbeitsbereichs, dem das Lakehouse zugeordnet ist. |
| OneLake-Pfadtyp |
Der Pfadtyp, der in OneLake verwendet wird. Wählen Sie "Dateien " oder "Tabellen" aus. |
| Authentifizierungsmethode |
Die für die Authentifizierung verwendete Methode. Wählen Sie die vom System zugewiesene verwaltete Identität oder die vom Benutzer zugewiesene verwaltete Identität aus. |
| Client-ID |
Die Client-ID einer benutzendenseitig zugewiesenen verwalteten Identität. Erforderlich, wenn die vom Benutzer zugewiesene verwaltete Identität verwendet wird. |
| Mandanten-ID |
Die Instanz-ID der benutzendenseitig zugewiesenen verwalteten Identität. Erforderlich, wenn die vom Benutzer zugewiesene verwaltete Identität verwendet wird. |
Wählen Sie Übernehmen aus, um den Endpunkt bereitzustellen.
Erstellen oder ersetzen
Verwenden Sie den Befehl az iot ops dataflow endpoint create fabric-onelake, um einen Microsoft Fabric OneLake-Datenflussendpunkt zu erstellen oder zu ersetzen.
az iot ops dataflow endpoint create fabric-onelake --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --workspace <WorkspaceName> --lakehouse <LakehouseName> --path-type <PathType>
Der --workspace Parameter ist der Name des Microsoft Fabric-Arbeitsbereichs.
--lakehouse ist der Name des Microsoft Fabric Lakehouse im Arbeitsbereich. Der Parameter --path-type gibt den OneLake-Pfadtyp an, Tables oder Files.
Hier ist ein Beispielbefehl zum Erstellen oder Ersetzen eines Microsoft Fabric OneLake-Datenflussendpunkts mit dem Namen fabric-endpoint:
az iot ops dataflow endpoint create fabric-onelake --resource-group myResourceGroup --instance myAioInstance --name fabric-endpoint --workspace myWorkspace --lakehouse myLakehouse --path-type Tables
Erstellen oder Ändern
Verwenden Sie den Befehl az iot ops dataflow endpoint apply, um einen Microsoft Fabric OneLake-Datenflussendpunkt zu erstellen oder zu ändern.
az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>
Der --config-file Parameter ist der Pfad und Dateiname einer JSON-Konfigurationsdatei, die die Ressourceneigenschaften enthält.
Gehen Sie in diesem Beispiel von einer Konfigurationsdatei fabric-endpoint.json mit dem folgenden Inhalt aus, der im Startverzeichnis des Benutzers gespeichert ist:
{
"endpointType": "FabricOneLake",
"fabricOneLakeSettings": {
"authentication": {
"method": "SystemAssignedManagedIdentity",
"systemAssignedManagedIdentitySettings": {}
},
"batching": {
"latencySeconds": 60,
"maxMessages": 100000
},
"host": "https://onelake.dfs.fabric.microsoft.com",
"oneLakePathType": "Tables",
"names": {
"workspaceName": "<WorkspaceName>",
"lakehouseName": "<LakehouseName>"
}
}
}
Hier ist ein Beispielbefehl zum Erstellen eines neuen Microsoft Fabric OneLake-Datenflussendpunkts mit dem Namen fabric-endpoint:
az iot ops dataflow endpoint apply --resource-group myResourceGroupName --instance myAioInstanceName --name fabric-endpoint --config-file ~/fabric-endpoint.json
Erstellen Sie eine Bicep-Datei (.bicep) mit folgendem Inhalt.
param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'
param endpointName string = '<ENDPOINT_NAME>'
param workspaceName string = '<WORKSPACE_NAME>'
param lakehouseName string = '<LAKEHOUSE_NAME>'
resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
name: aioInstanceName
}
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
name: customLocationName
}
resource oneLakeEndpoint 'Microsoft.IoTOperations/instances/dataflowEndpoints@2024-11-01' = {
parent: aioInstance
name: endpointName
extendedLocation: {
name: customLocation.id
type: 'CustomLocation'
}
properties: {
endpointType: 'FabricOneLake'
fabricOneLakeSettings: {
// The default Fabric OneLake host URL in most cases
host: 'https://onelake.dfs.fabric.microsoft.com'
authentication: {
// See available authentication methods section for method types
// method: <METHOD_TYPE>
}
oneLakePathType: 'Tables'
names: {
workspaceName: workspaceName
lakehouseName: lakehouseName
}
}
}
}
Stellen Sie sie dann über die Azure CLI bereit.
az deployment group create --resource-group <RESOURCE_GROUP> --template-file <FILE>.bicep
Erstellen Sie eine Kubernetes-Manifestdatei (.yaml) mit folgendem Inhalt.
apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowEndpoint
metadata:
name: <ENDPOINT_NAME>
namespace: azure-iot-operations
spec:
endpointType: FabricOneLake
fabricOneLakeSettings:
# The default Fabric OneLake host URL in most cases
host: https://onelake.dfs.fabric.microsoft.com
authentication:
# See available authentication methods section for method types
# method: <METHOD_TYPE>
oneLakePathType: Tables
names:
workspaceName: <WORKSPACE_NAME>
lakehouseName: <LAKEHOUSE_NAME>
Wenden Sie dann die Manifestdatei auf den Kubernetes-Cluster an.
kubectl apply -f <FILE>.yaml
OneLake-Pfadtyp
Die Einstellung oneLakePathType bestimmt die Art des zu verwendenden Pfads im OneLake-Pfad. Der Standardwert ist Tables (der empfohlene Pfadtyp für die gängigsten Anwendungsfälle). Der Pfadtyp Tables ist eine Tabelle im OneLake-Lakehouse, die zum Speichern der Daten verwendet wird. Er kann auch auf Files festgelegt werden. Hierbei handelt es sich um eine Datei im OneLake-Lakehouse, die zum Speichern der Daten verwendet wird. Der Pfadtyp Files ist nützlich, wenn Sie die Daten in einem Dateiformat speichern möchten, das vom Pfadtyp Tables nicht unterstützt wird.
Der OneLake-Pfadtyp wird auf der Registerkarte " Standard " für den Datenflussendpunkt festgelegt.
Wenn Sie den Befehl "az iot ops dataflow endpoint create fabric-onelake " verwenden, gibt der --path-type Parameter den OneLake-Pfadtyp an, der entweder Tables oder Filessein kann.
az iot ops dataflow endpoint create fabric-onelake --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --workspace <WorkspaceName> --lakehouse <LakehouseName> --path-type <PathType>
Wenn Sie den az iot ops dataflow endpoint apply verwenden, wird die oneLakePathType Eigenschaft in der JSON-Konfigurationsdatei festgelegt.
{
"endpointType": "FabricOneLake",
"fabricOneLakeSettings": {
"oneLakePathType": "Tables"
}
}
fabricOneLakeSettings: {
oneLakePathType: 'Tables' // Or 'Files'
}
fabricOneLakeSettings:
oneLakePathType: Tables # Or Files
Verfügbare Authentifizierungsmethoden
Die folgenden Authentifizierungsmethoden sind für Datenflussendpunkte der Microsoft Fabric OneLake-Datenflussendpunkte verfügbar.
Systemseitig zugewiesene verwaltete Identität
Bevor Sie den Datenflussendpunkt konfigurieren, weisen Sie der verwalteten Identität von Azure IoT Einsatz eine Rolle mit der Berechtigung zum Schreiben in das Fabric-Lakehouse zu:
- Wechseln Sie im Azure-Portal zu Ihrer Azure IoT Operations-Instanz, und wählen Sie "Übersicht" aus.
- Kopieren Sie den Namen der Erweiterung, die nach der Azure IoT Operations Arc-Erweiterung aufgeführt ist. Beispiel: azure-iot-operations-xxxx7.
- Wechseln Sie zum Microsoft Fabric-Arbeitsbereich, wählen Sie "Zugriff> verwalten" aus, und fügen Sie Personen oder Gruppen hinzu.
- Suchen Sie nach dem Namen Ihrer systemseitig zugewiesenen verwalteten Identität. Beispiel: azure-iot-operations-xxxx7.
- Wählen Sie eine entsprechende Rolle und dann "Hinzufügen" aus.
Konfigurieren Sie dann den Datenflussendpunkt mit den Einstellungen der systemseitig zugewiesenen verwalteten Identität.
Wählen Sie auf der Seite „Einstellungen“ für den Datenflussendpunkt auf der Einsatz-Benutzeroberfläche die Registerkarte Allgemeine Informationen und dann Authentifizierungsmethode>Systemseitig zugewiesene verwaltete Identität aus.
Erstellen oder ersetzen
Verwenden Sie den Befehl az iot ops dataflow endpoint create fabric-onelake, um einen Microsoft Fabric OneLake-Datenflussendpunkt zu erstellen oder zu ersetzen.
az iot ops dataflow endpoint create fabric-onelake --auth-type SystemAssignedManagedIdentity --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --workspace <WorkspaceName> --lakehouse <LakehouseName> --path-type <PathType>
Der --workspace Parameter ist der Name des Microsoft Fabric-Arbeitsbereichs.
--lakehouse ist der Name des Microsoft Fabric Lakehouse im Arbeitsbereich. Der Parameter --path-type gibt den OneLake-Pfadtyp an, Tables oder Files.
Hier ist ein Beispielbefehl zum Erstellen oder Ersetzen eines Microsoft Fabric OneLake-Datenflussendpunkts mit dem Namen fabric-endpoint:
az iot ops dataflow endpoint create fabric-onelake --resource-group myResourceGroup --instance myAioInstance --name fabric-endpoint --workspace myWorkspace --lakehouse myLakehouse --path-type Tables
Erstellen oder Ändern
Verwenden Sie den Befehl az iot ops dataflow endpoint apply, um einen Microsoft Fabric OneLake-Datenflussendpunkt zu erstellen oder zu ändern.
az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>
Der --config-file Parameter ist der Pfad und Dateiname einer JSON-Konfigurationsdatei, die die Ressourceneigenschaften enthält.
Gehen Sie in diesem Beispiel von einer Konfigurationsdatei fabric-endpoint.json mit dem folgenden Inhalt aus, der im Startverzeichnis des Benutzers gespeichert ist:
{
"endpointType": "FabricOneLake",
"fabricOneLakeSettings": {
"authentication": {
"method": "SystemAssignedManagedIdentity",
"systemAssignedManagedIdentitySettings": {}
},
"batching": {
"latencySeconds": 60,
"maxMessages": 100000
},
"host": "https://onelake.dfs.fabric.microsoft.com",
"oneLakePathType": "Tables",
"names": {
"workspaceName": "<WorkspaceName>",
"lakehouseName": "<LakehouseName>"
}
}
}
Hier ist ein Beispielbefehl zum Erstellen eines neuen Microsoft Fabric OneLake-Datenflussendpunkts mit dem Namen fabric-endpoint:
az iot ops dataflow endpoint apply --resource-group myResourceGroupName --instance myAioInstanceName --name fabric-endpoint --config-file ~/fabric-endpoint.json
fabricOneLakeSettings: {
authentication: {
method: 'SystemAssignedManagedIdentity'
systemAssignedManagedIdentitySettings: {}
}
}
fabricOneLakeSettings:
authentication:
method: SystemAssignedManagedIdentity
systemAssignedManagedIdentitySettings:
{}
Wenn Sie die Zielgruppe der systemseitig zugewiesenen verwalteten Identität außer Kraft setzen müssen, können Sie die Einstellung audience angeben.
In den meisten Fällen müssen Sie keine Dienstgruppe angeben. Wenn Sie keine Benutzendengruppe angeben, wird eine verwaltete Identität mit der Standardzielgruppe erstellt, die auf Ihr Speicherkonto ausgelegt ist.
Erstellen oder ersetzen
Verwenden Sie den Befehl az iot ops dataflow endpoint create fabric-onelake, um einen Microsoft Fabric OneLake-Datenflussendpunkt zu erstellen oder zu ersetzen.
az iot ops dataflow endpoint create fabric-onelake --auth-type SystemAssignedManagedIdentity fabric-onelake --audience https://<account>.onelake.dfs.fabric.microsoft.com --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --workspace <WorkspaceName> --lakehouse <LakehouseName> --path-type <PathType>
Der --audience Parameter gibt die Zielgruppe für die vom System zugewiesene verwaltete Identität an. Die Standard-Zielgruppe ist https://<account>.onelake.dfs.fabric.microsoft.com.
Hier ist ein Beispielbefehl zum Erstellen oder Ersetzen eines Microsoft Fabric OneLake-Datenflussendpunkts mit dem Namen fabric-endpoint:
az iot ops dataflow endpoint create fabric-onelake --auth-type SystemAssignedManagedIdentity --audience https://account.onelake.dfs.fabric.microsoft.com --resource-group myResourceGroup --instance myAioInstance --name fabric-endpoint --workspace myWorkspace --lakehouse myLakehouse --path-type Tables
Erstellen oder Ändern
Verwenden Sie den Befehl az iot ops dataflow endpoint apply, um einen Microsoft Fabric OneLake-Datenflussendpunkt zu erstellen oder zu ändern.
az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>
Der --config-file Parameter ist der Pfad und Dateiname einer JSON-Konfigurationsdatei, die die Ressourceneigenschaften enthält.
Gehen Sie in diesem Beispiel von einer Konfigurationsdatei fabric-endpoint.json mit dem folgenden Inhalt aus, der im Startverzeichnis des Benutzers gespeichert ist:
{
"endpointType": "FabricOneLake",
"fabricOneLakeSettings": {
"authentication": {
"method": "SystemAssignedManagedIdentity",
"systemAssignedManagedIdentitySettings": {
"audience": "https://<account>.onelake.dfs.fabric.microsoft.com"
}
},
"batching": {
"latencySeconds": 60,
"maxMessages": 100000
},
"host": "https://onelake.dfs.fabric.microsoft.com",
"oneLakePathType": "Tables",
"names": {
"workspaceName": "<WorkspaceName>",
"lakehouseName": "<LakehouseName>"
}
}
}
Hier ist ein Beispielbefehl zum Erstellen eines neuen Microsoft Fabric OneLake-Datenflussendpunkts mit dem Namen fabric-endpoint:
az iot ops dataflow endpoint apply --resource-group myResourceGroupName --instance myAioInstanceName --name fabric-endpoint --config-file ~/fabric-endpoint.json
fabricOneLakeSettings: {
authentication: {
method: 'SystemAssignedManagedIdentity'
systemAssignedManagedIdentitySettings: {
audience: 'https://<ACCOUNT>.onelake.dfs.fabric.microsoft.com'
}
}
}
fabricOneLakeSettings:
authentication:
method: SystemAssignedManagedIdentity
systemAssignedManagedIdentitySettings:
audience: https://<ACCOUNT>.onelake.dfs.fabric.microsoft.com
Benutzendenseitig zugewiesene verwaltete Identität
Um eine benutzendenseitig zugewiesene verwaltete Identität für die Authentifizierung zu verwenden, müssen Sie zuerst Azure IoT Einsatz mit aktivierten sicheren Einstellungen bereitstellen. Anschließend müssen Sie eine vom Benutzer zugewiesene verwaltete Identität für Cloudverbindungen einrichten. Weitere Informationen finden Sie unter Aktivieren sicherer Einstellungen in der Azure IoT Operations-Bereitstellung.
Bevor Sie den Datenflussendpunkt konfigurieren, weisen Sie der vom Benutzer zugewiesenen verwalteten Identität eine Rolle zu, die die Berechtigung zum Schreiben in das Fabric Lakehouse gewährt.
- Wechseln Sie zum Microsoft Fabric-Arbeitsbereich, wählen Sie "Zugriff> verwalten" aus, und fügen Sie Personen oder Gruppen hinzu.
- Suchen Sie nach dem Namen Ihrer benutzendenseitig zugewiesenen verwalteten Identität.
- Wählen Sie eine entsprechende Rolle und dann "Hinzufügen" aus.
Konfigurieren Sie danach den Datenflussendpunkt mit den Einstellungen der benutzendenseitig zugewiesenen verwalteten Identität.
Wählen Sie auf der Seite "Einstellungen für Betriebserfahrungsdatenfluss-Endpunkteinrichtung" die Registerkarte "Standard" und dann "Authentifizierungsmethode>Benutzer zugewiesene verwaltete Identität" aus.
Geben Sie die Client-ID und die Mandanten-ID der benutzendenseitig zugewiesenen verwalteten Identität in die entsprechenden Felder ein.
Erstellen oder ersetzen
Verwenden Sie den Befehl az iot ops dataflow endpoint create fabric-onelake, um einen Microsoft Fabric OneLake-Datenflussendpunkt mit einer vom Benutzer zugewiesenen verwalteten Identität zu erstellen oder zu ersetzen.
az iot ops dataflow endpoint create fabric-onelake --auth-type UserAssignedManagedIdentity --client-id <ClientId> --tenant-id <TenantId> --scope <Scope> --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --workspace <WorkspaceName> --lakehouse <LakehouseName> --path-type <PathType>
Der --auth-type Parameter gibt die Authentifizierungsmethode an, die in diesem Fall liegt UserAssignedManagedIdentity . Die Parameter --client-id, --tenant-id und --scope geben jeweils die Client-ID der benutzendenseitig zugewiesenen verwalteten Identität, die Mandanten-ID und den Bereich an.
Hier ist ein Beispielbefehl zum Erstellen oder Ersetzen eines Microsoft Fabric OneLake-Datenflussendpunkts mit dem Namen fabric-endpoint:
Beispiel für einen -Befehl:
az iot ops dataflow endpoint create fabric-onelake --auth-type UserAssignedManagedIdentity --client-id ClientId --tenant-id TenantId --scope https://storage.azure.com/.default --resource-group myResourceGroup --instance myAioInstance --name fabric-endpoint --workspace myWorkspace --lakehouse myLakehouse --path-type Tables
Erstellen oder Ändern
Verwenden Sie den Befehl az iot ops dataflow endpoint apply, um einen Microsoft Fabric OneLake-Datenflussendpunkt mit benutzerzugewiesener verwalteter Identität zu erstellen oder zu ändern.
az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>
Der --config-file Parameter ist der Pfad und Dateiname einer JSON-Konfigurationsdatei, die die Ressourceneigenschaften enthält.
Beispiel fabric-endpoint.json:
{
"endpointType": "FabricOneLake",
"fabricOneLakeSettings": {
"authentication": {
"method": "UserAssignedManagedIdentity",
"userAssignedManagedIdentitySettings": {
"clientId": "<ClientId>",
"scope": "<Scope>",
"tenantId": "<TenantId>"
}
},
"batching": {
"latencySeconds": 60,
"maxMessages": 100000
},
"host": "https://onelake.dfs.fabric.microsoft.com",
"oneLakePathType": "Tables",
"names": {
"workspaceName": "<WorkspaceName>",
"lakehouseName": "<LakehouseName>"
}
}
}
Beispiel für einen -Befehl:
az iot ops dataflow endpoint apply --resource-group myResourceGroupName --instance myAioInstanceName --name fabric-endpoint --config-file ~/fabric-endpoint.json
fabricOneLakeSettings: {
authentication: {
method: 'UserAssignedManagedIdentity'
userAssignedManagedIdentitySettings: {
clientId: '<ID>'
tenantId: '<ID>'
// Optional, defaults to 'https://storage.azure.com/.default'
// scope: 'https://<SCOPE_URL>'
}
}
}
Um eine benutzendenseitig zugewiesene verwaltete Identität zu verwenden, geben Sie die Authentifizierungsmethode UserAssignedManagedIdentity an, und stellen Sie die clientId und die tenantId der verwalteten Identität bereit.
fabricOneLakeSettings:
authentication:
method: UserAssignedManagedIdentity
userAssignedManagedIdentitySettings:
clientId: <ID>
tenantId: <ID>
# Optional, defaults to 'https://storage.azure.com/.default'
# scope: https://<SCOPE_URL>
Hier ist der Umfang optional und standardmäßig auf https://storage.azure.com/.default festgelegt. Wenn Sie den Standardbereich überschreiben müssen, geben Sie die Einstellung scope mit Bicep oder Kubernetes an.
Erweiterte Einstellungen
Sie können erweiterte Einstellungen für den Fabric OneLake-Endpunkt festlegen, z. B. die Batchlatenz und die Nachrichtenanzahl. Sie können diese Einstellungen auf der Registerkarte "Erweiterter Portal" des Datenflussendpunkts oder in der benutzerdefinierten Ressource des Datenflussendpunkts festlegen.
Batching
Verwenden Sie die batching-Einstellungen, um die maximale Anzahl von Nachrichten und die maximale Latenz zu konfigurieren, bevor die Nachrichten an das Ziel gesendet werden. Diese Einstellung ist nützlich, wenn Sie die Netzwerkbandbreite optimieren und die Anzahl der Anforderungen an das Ziel reduzieren möchten.
| Feld |
Beschreibung |
Erforderlich |
latencySeconds |
Die maximale Anzahl von Sekunden, die vor dem Senden der Nachrichten an das Ziel gewartet werden sollen. Der Standardwert beträgt 60 Sekunden. |
Nein |
maxMessages |
Die maximale Anzahl der Nachrichten, die an das Ziel gesendet werden sollen. Der Standardwert beträgt 100.000 Meldungen. |
Nein |
Wenn Sie beispielsweise die maximale Anzahl von Nachrichten auf 1.000 und die maximale Latenz auf 100 Sekunden konfigurieren möchten, verwenden Sie die folgenden Einstellungen:
Wählen Sie in der Betriebsumgebung die Registerkarte "Erweitert " für den Datenflussendpunkt aus.
Verwenden Sie den Befehl az iot ops dataflow endpoint apply, um erweiterte Einstellungen des Microsoft Fabric OneLake Dataflow-Endpunkts zu erstellen oder zu ändern.
az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>
Der --config-file Parameter ist der Pfad und Dateiname einer JSON-Konfigurationsdatei, die die Ressourceneigenschaften enthält.
Gehen Sie in diesem Beispiel von einer Konfigurationsdatei fabric-endpoint.json mit dem folgenden Inhalt aus, der im Startverzeichnis des Benutzers gespeichert ist:
{
"endpointType": "FabricOneLake",
"fabricOneLakeSettings": {
"authentication": {
"method": "SystemAssignedManagedIdentity",
"systemAssignedManagedIdentitySettings": {}
},
"batching": {
"latencySeconds": 100,
"maxMessages": 1000
},
"host": "https://onelake.dfs.fabric.microsoft.com",
"oneLakePathType": "Tables",
"names": {
"workspaceName": "<WorkspaceName>",
"lakehouseName": "<LakehouseName>"
}
}
}
Hier ist ein Beispielbefehl zum Erstellen eines neuen Microsoft Fabric OneLake-Datenflussendpunkts mit dem Namen fabric-endpoint:
az iot ops dataflow endpoint apply --resource-group myResourceGroupName --instance myAioInstanceName --name fabric-endpoint --config-file ~/fabric-endpoint.json
fabricOneLakeSettings: {
batching: {
latencySeconds: 100
maxMessages: 1000
}
}
fabricOneLakeSettings:
batching:
latencySeconds: 100
maxMessages: 1000
Nächste Schritte
Weitere Informationen zu Datenflüssen finden Sie unter "Datenfluss erstellen".