Trabajar con definiciones de columna de archivo mediante código

  • Artikulua

Use columnas de archivo para almacenar datos de archivo hasta un tamaño máximo especificado. Las columnas archivo se optimizan para almacenar datos binarios. Dataverse no guarda estos datos en el almacén de datos relacional, lo que mejora el rendimiento y reduce el uso de capacidad. Más información sobre la capacidad de almacenamiento

Una tabla personalizada o personalizable puede tener cero o más columnas de archivo. En este artículo se explica cómo trabajar con definiciones de columna en código. Para utilizar los datos almacenados en estas columnas, consulte Usar datos de columna de archivo.

Crear columnas de archivo

La forma recomendada de crear columnas de archivo es usar Power Apps y definir sus columnas usando el diseñador. Más información: Columnas de archivos.

Nota

Una consideración clave al crear columnas de archivos es el Tamaño máximo de archivo almacenado en la propiedad MaxSizeInKB. La configuración predeterminada para esto es 32768 o 32 MB. El valor máximo es 10485760 KB (10 GB). Si bien la API puede manejar archivos de hasta 10 GB de tamaño, las solicitudes deben ser "fragmentadas". El límite de tamaño para enviar una única solicitud es de 128 MB. Cuando una aplicación cliente intenta enviar un archivo de más de 128 MB en una sola solicitud, se generará un error. Aprenda a cargar archivos.

El valor MaxSizeInKB no se puede cambiar en Power Apps usando el diseñador después de crear la columna del archivo. Puede utilizar la API para actualizar la propiedad MaxSizeInKB. Más información: Actualizar una columna usando una API web y Actualizar una columna usando SDK

También puede crear columnas de archivo usando el SDK de Dataverse para .NET o usando la API web. Los siguientes ejemplos muestran cómo:

Use la Clase FileAttributeMetadata con la Clase CreateAttributeRequest para crear una columna de archivo.

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

}

Use la propiedad FileAttributeMetadata.MaxSizeInKB para establecer el tamaño máximo.

Más información:

Tipos de archivo bloqueados

Puede controlar qué tipos de archivos no se pueden guardar en columnas de archivo según la extensión del archivo y el tipo mime.

Más información:

Restricciones con clave autoadministrable (BYOK)

Importante

Se aplican algunas restricciones al usar el archivo y los tipos de datos de imagen de tamaño completo en Dataverse. Si las claves autoadministrables (BYOK) están habilitadas en el inquilino, los tipos de datos de IoT no están disponibles para las organizaciones del inquilino. Las soluciones que contienen tipos de datos excluidos no se instalan. Los clientes deben cancelar la suscripción a BYOK para hacer uso de estos tipos de datos.

Todas las organizaciones de BYOK a partir de la versión: 9.2.21052.00103 pueden admitir el uso de tipos de datos de archivo e imagen de Dataverse. Los archivos dentro de las organizaciones BYOK están limitados a un tamaño máximo de 128 MB por archivo. Todos los archivos e imágenes dentro de las organizaciones de BYOK se almacenarán en el almacenamiento relacional de Dataverse, en lugar del almacenamiento de blobs de archivos de Dataverse. Otras limitaciones:

  • Las descargas SAS de delegación de usuarios no son compatibles
  • Las cargas y descargas fragmentadas están limitadas a una sola parte

Consulte también

Usar datos de columna de archivo
Trabajar con definiciones de columna de imagen mediante código

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).