Partager via


Utiliser des définitions de colonne de fichier avec du code

Utilisez des colonnes de fichier pour stocker des données de fichier jusqu’à une taille maximale spécifiée. Les colonnes Fichier sont optimisées pour stocker des données binaires. Dataverse ne sauvegarde pas ces données dans le magasin de données relationnel, ce qui améliore les performances et réduit l’utilisation de la capacité. En savoir plus sur la capacité de stockage

Une table personnalisée ou personnalisable peut avoir zéro ou plus de colonnes de fichier. Cet article décrit l’utilisation des définitions de colonne dans le code. Pour utiliser les données stockées dans ces colonnes, consultez Utiliser les données de colonne de fichier.

Créer des colonnes de fichier

La méthode recommandée pour créer des colonnes de fichier consiste à utiliser Power Apps et à définir vos colonnes en utilisant le concepteur. Pour plus d’informations : Colonnes de fichier.

Notes

Une considération clé lors de la création de colonnes de fichier est la Taille de fichier maximale stockée dans la propriété MaxSizeInKB. Le paramètre par défaut correspondant est 32768 ou 32 Mo. La valeur maximale est 10485760 Ko (10 Go). Bien que l’API puisse gérer des fichiers d’une taille allant jusqu’à 10 Go, les requêtes doivent être « fragmentées ». La taille limite pour envoyer une seule requête est de 128 Mo. Lorsqu’une application client tente d’envoyer un fichier de plus de 128 Mo en une seule requête, une erreur est générée. Apprendre à charger les fichiers.

La valeur MaxSizeInKB ne peut pas être modifiée dans Power Apps en utilisant le concepteur après la création de la colonne de fichier. Vous pouvez utiliser l’API pour mettre à jour la propriété MaxSizeInKB. Pour plus d’informations : Mettre à jour une colonne en utilisant l’API web et Mettre à jour une colonne en utilisant le SDK

Vous pouvez également créer des colonnes de fichier en utilisant le SDK Dataverse pour .NET ou l’API web. Les exemples suivants montrent comment :

Utilisez la Classe FileAttributeMetadata avec la Classe CreateAttributeRequest pour créer une colonne de fichier.

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);

}

Utilisez la propriété FileAttributeMetadata.MaxSizeInKB pour définir la taille maximale.

Pour plus d’informations :

Types de fichiers bloqués

Vous pouvez contrôler quels types de fichiers ne sont pas autorisés à être enregistrés dans les colonnes de fichiers en fonction de l’extension de fichier et du type mime.

Pour plus d’informations :

Restrictions avec clé autogérée (BYOK)

Important

Certaines restrictions s’appliquent lors de l’utilisation des données de type Fichier et Image en taille réelle dans Dataverse. Si la clé auto-gérée (BYOK) est activée sur le locataire, les types de données IoT ne sont pas disponibles pour les organisations du locataire. Les solutions qui contiennent des types de données exclus ne s’installeront pas. Les clients doivent désactiver les clés gérées par eux afin de pouvoir utiliser ces types de données.

Toutes les organisations BYOK à partir de la version 9.2.21052.00103 peuvent prendre en charge l’utilisation des types de données d’image et de fichier Dataverse. Les fichiers au sein des organisations BYOK sont limités à une taille maximale de 128 Mo par fichier. Tous les fichiers et images des organisations BYOK seront stockés dans le stockage relationnel Dataverse, au lieu du Stockage Blob Dataverse. Autres limitations :

  • Les téléchargements SAS de délégation d’utilisateurs ne sont pas pris en charge
  • Les chargements et téléchargements en bloc sont limités à un seul bloc

Voir aussi

Utiliser les données de colonne de fichier
Utiliser des définitions de colonne d’image avec du code

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).