Mithilfe von Code mit Dateispaltendefinitionen arbeiten

  • Artikel

Verwenden Sie Dateispalten, um Dateidaten bis zu einer bestimmten maximalen Größe zu speichern. Dateispalten sind zum Speichern von Binärdaten optimiert. Dataverse speichert diese Daten nicht im relationalen Datenspeicher, was die Leistung verbessert und die Kapazitätsnutzung reduziert. Weitere Informationen zur Speicherkapazität

Eine benutzerdefinierte oder anpassbare Tabelle kann null oder mehr Dateispalten aufweisen. Dieser Artikel behandelt das Arbeiten mit Spaltendefinitionen in Code. Weitere Informationen zur Verwendung von Daten, die in diesen Spalten gespeichert sind, finden Sie unter Dateispaltendaten verwenden.

Dateispalten erstellen

Die empfohlene Methode zum Erstellen von Dateispalten ist die Verwendung von Power Apps und das Definieren Ihrer Spalten mit dem Designer. Weitere Informationen: Dateispalten

Hinweis

Eine wichtige Überlegung beim Erstellen von Dateispalten ist die maximale Dateigröße, die in der Eigenschaft MaxSizeInKB gespeichert ist. Die Standardeinstellung für diese Eigenschaft ist 32768 oder 32 MB. Der maximale Wert ist 10485760 KB (10 GB). Während die API Dateien mit einer Größe von bis zu 10 GB verarbeiten kann, müssen die Anforderungen „unterteilt“ sein. Die Größenbeschränkung zum Senden einer einzelnen Anforderung beträgt 128 MB. Wenn eine Clientanwendung versucht, eine Datei mit mehr als 128 MB in einer einzelnen Anforderung zu senden, wird ein Fehler ausgegeben. Informationen zum Hochladen von Dateien

Der MaxSizeInKB-Wert kann mit dem Designer nach Erstellen der Dateispalte nicht in Power Apps geändert werden. Sie können auch die API zum Aktualisieren der Eigenschaft MaxSizeInKB verwenden. Weitere Informationen: Eine Spalte über die Web-API aktualisieren und Eine Spalte über das SDK aktualisieren

Sie können Dateispalten auch mithilfe des Dataverse-SDK für .NET oder über die Web-API erstellen. Die Vorgehensweise wird im folgenden Beispiel veranschaulicht:

Verwenden Sie die FileAttributeMetadata-Klasse mit der CreateAttributeRequest-Klasse, um eine Dateispalte zu erstellen.

public static void CreateFileColumn(
   IOrganizationService service, 
   string entityLogicalName, 
   string fileColumnSchemaName) 
{

    FileAttributeMetadata fileColumn = new()
    {
        SchemaName = fileColumnSchemaName,
        DisplayName = new Label("Sample File Column", 1033),
        RequiredLevel = new AttributeRequiredLevelManagedProperty(
                AttributeRequiredLevel.None),
        Description = new Label("Sample File Column for FileOperation samples", 1033),
        MaxSizeInKB = 30 * 1024 // 30 MB

    };

    CreateAttributeRequest createfileColumnRequest = new() {
        EntityName = entityLogicalName,
        Attribute = fileColumn                   
    };

    service.Execute(createfileColumnRequest);

}

Verwenden Sie die Eigenschaft FileAttributeMetadata.MaxSizeInKB, um die maximale Größe festzulegen.

Weitere Informationen:

Gesperrte Dateitypen

Sie können anhand der Dateierweiterung und des Mime-Typs steuern, welche Typen von Dateien nicht in Dateispalten gespeichert werden dürfen.

Weitere Informationen:

Einschränkungen mit selbstverwaltetem Schlüssel (BYOK)

Wichtig

Einige Einschränkungen gelten, wenn die Datei und die Bilddatentypen in voller Größe in Dataverse verwendet werden. Wenn selbstverwaltete Schlüssel (BYOK) auf dem Mandanten aktiviert sind, stehen den Organisationen des Mandanten keine IoT-Datentypen zur Verfügung. Lösungen, die ausgeschlossene Datentypen enthalten, werden nicht installiert. Kunden müssen sich bei BYOK abmelden, um diese Daten verwenden zu können.

Alle BYOK-Organisationen ab Version: 9.2.21052.00103 können die Nutzung der Datei- und Bilddatentypen von Dataverse unterstützen. Dateien innerhalb von BYOK-Organisationen sind auf eine maximale Größe von 128 MB pro Datei beschränkt. Alle Dateien und Bilder innerhalb von BYOK-Organisationen werden im relationalen Speicher von Dataverse gespeichert und nicht im Blob Storage für Dateien von Dataverse. Weitere Einschränkungen:

  • SAS-Downloads zur Benutzerdelegierung werden nicht unterstützt.
  • Die Segmentierung von Uploads und Downloads ist auf ein einzelnes Segment beschränkt.

Siehe auch

Dateispaltendaten verwenden
Mithilfe von Code mit Bildspaltendefinitionen arbeiten

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).