Compartir a través de

Copia de datos de Shopify mediante Azure Data Factory o Synapse Analytics

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis integral para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y la creación de informes. Obtenga información sobre cómo iniciar una nueva evaluación gratuita.

En este artículo se explica cómo usar la actividad de copia en una canalización de Azure Data Factory o Synapse Analytics para copiar datos de Shopify. El documento se basa en el artículo de introducción a la actividad de copia que describe información general de la actividad de copia.

Importante

La versión 1.0 del conector Shopify está en la fase de eliminación. Se recomienda actualizar el conector shopify de la versión 1.0 a la 2.0.

Funcionalidades admitidas

El conector Shopify es compatible para las siguientes funcionalidades:

Funcionalidades admitidas IR
Actividad de copia (origen/-) 1 2
Actividad de búsqueda 1 2

① Azure Integration Runtime ② Entorno de ejecución de integración autohospedado

Para obtener una lista de los almacenes de datos que se admiten como orígenes y receptores, consulte la tabla de almacenes de datos admitidos.

El servicio proporciona un controlador integrado para habilitar la conectividad. Por lo tanto, no es necesario instalar manualmente ningún controlador mediante este conector.

El conector admite las versiones de Windows de este artículo.

La propiedad de columna billing_on se quitó de las tablas Recurring_Application_Charges y UsageCharge debido al desuso oficial de Shopify del campo billing_on.

Nota:

Para la versión 2.0, los nombres de columna conservan la estructura de Shopify GraphQL, como data.customers.edges.node.createdAt. Para la versión 1.0, los nombres de columna usan nombres simplificados, por ejemplo, Created_At.

Introducción

Para realizar la actividad de copia con una canalización, puede usar una de los siguientes herramientas o SDK:

Creación de un servicio vinculado a Shopify mediante la interfaz de usuario

Siga estos pasos para crear un servicio vinculado a Shopify en la interfaz de usuario de Azure Portal.

  1. Vaya a la pestaña "Administrar" de su área de trabajo de Azure Data Factory o Synapse y seleccione "Servicios vinculados"; a continuación, haga clic en "Nuevo":

  2. Busque Shopify y seleccione el conector de Shopify.

    Captura de pantalla del conector de Shopify.

  3. Configure los detalles del servicio, pruebe la conexión y cree el servicio vinculado.

    Captura de pantalla de la configuración del servicio vinculado en Shopify.

Detalles de configuración del conector

En las secciones siguientes se proporcionan detalles sobre las propiedades que se usan para definir entidades de Data Factory específicas del conector Shopify.

Propiedades del servicio vinculado

El conector shopify ahora admite la versión 2.0. Consulte esta sección para actualizar la versión del conector de Shopify desde la versión 1.0. Para obtener los detalles de la propiedad, consulte las secciones correspondientes.

Versión 2.0

El servicio vinculado shopify admite las siguientes propiedades cuando se aplica la versión 2.0:

Propiedad Descripción Obligatorio
type La propiedad type debe establecerse en: Shopify. Sí
version Versión que especifique. El valor es 2.0. Sí
host Punto de conexión del servidor de Shopify (es decir, mystore.myshopify.com). Sí
accessToken Token de acceso de API que puede utilizarse para tener acceso a los datos del Shopify. El token no expira si está en modo sin conexión. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault. Sí

Ejemplo:

{
    "name": "ShopifyLinkedService",
    "properties": {
        "type": "Shopify",
        "version": "2.0",
        "typeProperties": {
            "host" : "mystore.myshopify.com",
            "accessToken": {
                 "type": "SecureString",
                 "value": "<accessToken>"
            }
        }
    }
}

Versión 1.0

El servicio vinculado de Shopify admite las siguientes propiedades cuando se aplica la versión 1.0:

Propiedad Descripción Obligatorio
type La propiedad type debe establecerse en: Shopify. Sí
host Punto de conexión del servidor de Shopify (es decir, mystore.myshopify.com). Sí
accessToken Token de acceso de API que puede utilizarse para tener acceso a los datos del Shopify. El token no expira si está en modo sin conexión. Marque este campo como SecureString para almacenarlo de forma segura, o bien haga referencia a un secreto almacenado en Azure Key Vault. Sí
useEncryptedEndpoints Especifica si los puntos de conexión de origen de datos se cifran mediante HTTPS. El valor predeterminado es true. No
useHostVerification Especifica si se requiere que el nombre de host del certificado del servidor coincida con el nombre de host del servidor al conectarse a través de TLS. El valor predeterminado es true. No
usePeerVerification Especifica si se debe verificar la identidad del servidor al conectarse a través de TLS. El valor predeterminado es true. No

Ejemplo:

{
    "name": "ShopifyLinkedService",
    "properties": {
        "type": "Shopify",
        "typeProperties": {
            "host" : "mystore.myshopify.com",
            "accessToken": {
                 "type": "SecureString",
                 "value": "<accessToken>"
            }
        }
    }
}

Propiedades del conjunto de datos

Si desea ver una lista completa de las secciones y propiedades disponibles para definir conjuntos de datos, consulte el artículo sobre conjuntos de datos. En esta sección se proporciona una lista de las propiedades que admite el conjunto de datos de Shopify.

Para copiar datos de Shopify, establezca la propiedad type del conjunto de datos en ShopifyObject. Se admiten las siguientes propiedades:

Propiedad Descripción Obligatorio
type La propiedad type del conjunto de datos debe establecerse en: ShopifyObject Sí
tableName Nombre de la tabla.

Para la versión 2.0, los nombres de tabla conservan la estructura de Shopify GraphQL, por ejemplo customers.

En la versión 1.0, los nombres de tabla usan nombres simplificados con prefijos, por ejemplo, "Shopify"."Customers".		 No (si se especifica "query" en el origen de la actividad)

Nota:

No se puede leer la columna tags al especificar tableName en el conjunto de datos. Para leer esta columna, use query.

Ejemplo

{
    "name": "ShopifyDataset",
    "properties": {
        "type": "ShopifyObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Shopify linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Propiedades de la actividad de copia

Si desea ver una lista completa de las secciones y propiedades disponibles para definir actividades, consulte el artículo sobre canalizaciones. En esta sección se proporciona una lista de las propiedades que admite el origen de Shopify.

Shopify como origen

Para copiar datos desde Shopify, establezca el tipo de origen de la actividad de copia en ShopifySource. Se admiten las siguientes propiedades en la sección source de la actividad de copia:

Propiedad Descripción Obligatorio
type La propiedad type del origen de la actividad de copia debe establecerse en: ShopifySource Sí
Query Para la versión 2.0, use la consulta GraphQL para leer datos. Para más información sobre esta consulta, consulte este artículo. Tenga en cuenta que la consulta de paginación solo se admite para tablas externas y cada registro de la tabla externa puede incluir hasta 250 registros de tabla interna.

Para la versión 1.0, use la consulta SQL personalizada para leer datos. Por ejemplo: "SELECT * FROM "Products" WHERE Product_Id = '123'".		 No (si se especifica "tableName" en el conjunto de datos)

Ejemplo:

"activities":[
    {
        "name": "CopyFromShopify",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Shopify input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ShopifySource"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Asignación de tipos de datos para Shopify

Al copiar datos de Shopify, se aplican las siguientes asignaciones de los tipos de datos de Shopify a los tipos de datos internos utilizados por el servicio. Para más información acerca de la forma en que la actividad de copia asigna el tipo de datos y el esquema de origen al receptor, consulte el artículo sobre asignaciones de tipos de datos y esquema.

Tipo de datos Shopify Tipo de datos de servicio provisional (para la versión 2.0) Tipo de datos de servicio provisional (para la versión 1.0)
Boolean Boolean Boolean
Int Int Int
UnsignedInt64 UInt64 UInt64
Decimal Decimal Decimal
Float Double Double
String String String
Fecha Fecha Fecha
DateTime DateTime DateTime
identificación String String
URL String String
Código de país String String
Otros tipos de datos personalizados String String

Propiedades de la actividad de búsqueda

Para obtener información detallada sobre las propiedades, consulte Actividad de búsqueda.

Ciclo de vida y actualización del conector de Shopify

En la tabla siguiente se muestran la fase de lanzamiento y los registros de cambios para diferentes versiones del conector Shopify:

Versión Fase de versión Registro de cambios
Versión 1.0 Quitado No aplicable.
Versión 2.0 Disponibilidad general • Los nombres de tabla y columna conservan la estructura GraphQL de Shopify.

• Se admite solo la consulta GraphQL.

• useEncryptedEndpoints, useHostVerification, usePeerVerification no se admiten en el servicio vinculado.

Actualización del conector de Shopify de la versión 1.0 a la versión 2.0

  1. En página Editar servicio vinculado seleccione 2.0 para la versión. Para obtener más información, consulte propiedades del servicio vinculado versión 2.0.
  2. Para la versión 2.0, tenga en cuenta que los nombres de tabla y columna conservan la estructura de Shopify GraphQL.
  3. Si utiliza una consulta SQL en el origen de la actividad de copia o en la actividad de búsqueda que hace referencia al servicio vinculado de la versión 1.0, se debe convertirla a una consulta GraphQL. Para más información sobre esta consulta, consulte este artículo.

Contenido relacionado

Para obtener una lista de los almacenes de datos que admite la actividad de copia como orígenes y receptores, consulte Almacenes de datos compatibles.

  • Last updated on