Inserción de datos en un conjunto de datos de Power BIPush data into a Power BI dataset

Con la API de Power BI, puede insertar datos en un conjunto de datos de Power BI.With the Power BI API, you can push data into a Power BI dataset. Por ejemplo, supongamos que quiere ampliar un flujo de trabajo de empresa existente para insertar datos clave en el conjunto de datos.For example, you want to extend an existing business workflow to push key data into your dataset. En este caso, pongamos que quiere insertar un conjunto de datos de marketing de ventas que tiene una tabla de productos en un conjunto de datos.In this case, you want to push a Sales Marketing dataset which has a Product table into a dataset.

Antes de empezar a insertar datos en un conjunto de datos, necesita Azure Active Directory (Azure AD) y una cuenta de Power BI.Before you get started pushing data into a dataset, you need an Azure Active Directory (Azure AD) and a Power BI account.

Pasos para insertar datos en un conjunto de datosSteps to push data into a dataset

La siguiente sección es una discusión general de las operaciones de la API de Power BI que insertan datos.The next section is a general discussion of Power BI API operations that push data.

Operaciones de la API de Power BI para insertar datosPower BI API operations to push data

Con la API de REST de Power BI, puede insertar orígenes de datos en Power BI.With the Power BI REST API, you can push data sources to Power BI. Cuando una aplicación agrega filas a un conjunto de datos, los iconos del panel se actualizan automáticamente con los datos actualizados.When an app adds rows to a dataset, tiles on the dashboard are updated automatically with the updated data. Para insertar datos, se usa la operación Crear conjunto de datos junto con la operación Agregar filas.To push data, you use the Create Dataset operation along with the Add Rows operation. Para buscar un conjunto de datos, se usa la operación Obtener conjuntos de datos.To find a dataset, you use the Get Datasets operation. Para cualquiera de estas operaciones, puede pasar un identificador de grupo para trabajar con un grupo.For any of these operations, you can pass a group id to work with a group. Use la operación Obtener grupos para obtener una lista de identificadores de grupo.Use the Get Groups operation to get a list of group id's.

Estas son las operaciones para insertar datos en un conjunto de datos:Here are the operations to push data into a dataset:

Para crear un conjunto de datos en Power BI se pasa una cadena de notación de objetos JavaScript (JSON) al servicio Power BI.You create a dataset in Power BI by passing a JavaScript Object Notation (JSON) string to the Power BI service. Para obtener más información acerca de JSON, consulte Introducción a JSON.To learn more about JSON, see Introducing JSON.

La cadena JSON para un conjunto de datos tiene el formato siguiente:The JSON string for a dataset has the following format:

Objeto JSON de conjunto de datos de Power BIPower BI Dataset JSON object

{"name": "dataset_name", "tables":
    [{"name": "", "columns":
        [{ "name": "column_name1", "dataType": "data_type"},
         { "name": "column_name2", "dataType": "data_type"},
         { ... }
        ]
      }
    ]
}

Por lo tanto, en nuestro ejemplo de conjunto de datos de marketing de ventas, pasaría una cadena JSON como en el ejemplo siguiente.So, for our Sales Marketing dataset example, you would pass a JSON string such as the example below. En este ejemplo, SalesMarketing es el nombre del conjunto de datos y Product es el nombre de la tabla.In this example, SalesMarketing is the name of the dataset, and Product is the name of the table. Después de definir la tabla, debes definir el esquema de la tabla.After you define the table, you define the table schema. Para el conjunto de datos SalesMarketing , el esquema de la tabla tiene las siguientes columnas: ProductID, Manufacturer, Category, Segment, Product e IsCompete.For the SalesMarketing dataset, the table schema has these columns: ProductID, Manufacturer, Category, Segment, Product, and IsCompete.

Ejemplo de JSON de objeto de conjunto de datosExample dataset object JSON

{
    "name": "SalesMarketing",
    "tables": [
        {
            "name": "Product",
            "columns": [
            {
                "name": "ProductID",
                "dataType": "int"
            },
            {
                "name": "Manufacturer",
                "dataType": "string"
            },
            {
                "name": "Category",
                "dataType": "string"
            },
            {
                "name": "Segment",
                "dataType": "string"
            },
            {
                "name": "Product",
                "dataType": "string"
            },
            {
                "name": "IsCompete",
                "dataType": "bool"
            }
            ]
        }
    ]
}

Para un esquema de tabla de Power BI, puede usar los siguientes tipos de datos.For a Power BI table schema, you can use the following data types.

Tipos de datos de tabla de Power BIPower BI table data types

Tipo de datosData type RestriccionesRestrictions
Int64Int64 Int64.MaxValue e Int64.MinValue no están permitidos.Int64.MaxValue and Int64.MinValue not allowed.
DobleDouble Double.MaxValue y Double.MinValue no están permitidos.Double.MaxValue and Double.MinValue values not allowed. NaN no se admite. +Infinity y -Infinity no se admiten en algunas funciones (por ejemplo, Min, Max).NaN not supported.+Infinity and -Infinity not supported in some functions (e.g. Min, Max).
BooleanoBoolean NingunoNone
Fecha y horaDatetime Durante la carga de datos se cuantifican valores con fracciones de día a múltiplos enteros de 1/300 segundos (3,33 ms).During data loading we quantize values with day fractions to whole multiples of 1/300 seconds (3.33ms).
CadenaString Actualmente permite hasta 128K caracteres.Currently allows up to 128K characters.

Más información sobre la inserción de datos en Power BILearn more about pushing data into Power BI

Para comenzar a insertar datos en un conjunto de datos, consulte Paso 1: Registrar una aplicación con Azure AD en el panel de navegación izquierdo.To get started pushing data into a dataset, see Step 1: Register an app with Azure AD in the left navigation pane.

Paso siguiente >Next Step >

Pasos siguientesNext steps

Suscribirse en Power BISign up for Power BI
Crear conjunto de datosCreate Dataset
Obtener conjuntos de datosGet Datasets
Agregar filasAdd Rows
Obtener gruposGet Groups
Introducción a JSONIntroducing JSON
Información general sobre la API de REST de Power BIOverview of Power BI REST API
¿Tiene más preguntas?More questions? Pruebe la comunidad de Power BITry the Power BI Community