Gegevens uit Couchbase kopiëren met behulp van Azure Data Factory (preview)

Van toepassing op: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory in Microsoft Fabric is de volgende generatie van Azure Data Factory, met een eenvoudigere architectuur, ingebouwde AI en nieuwe functies. Als u nieuw bent in gegevensintegratie, begint u met Fabric Data Factory. Bestaande ADF-workloads kunnen upgraden naar Fabric om toegang te krijgen tot nieuwe mogelijkheden voor gegevenswetenschap, realtime analyses en rapportage.

Belangrijk

Deze connector bevindt zich aan het einde van de ondersteuningsfase. U wordt aangeraden om naar de ODBC-connector te migreren door een stuurprogramma te installeren.

In dit artikel wordt beschreven hoe u de kopieeractiviteit gebruikt in een pijplijn van Azure Data Factory of Synapse Analytics om gegevens te kopiëren van Couchbase. Het is gebaseerd op het kopieeractiviteitsoverzicht-artikel dat een algemeen overzicht van kopieeractiviteit presenteert.

Ondersteunde mogelijkheden

Deze Couchbase-connector wordt ondersteund voor de volgende mogelijkheden:

Ondersteunde mogelijkheden IR
Copy activity (bron/-) (1) (2)
Lookup-activiteit (1) (2)

(1) Azure Integration Runtime (2) Zelf-gehoste Integration Runtime

Zie de tabel Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen/sinks.

De service biedt een ingebouwd stuurprogramma om connectiviteit in te schakelen, daarom hoeft u geen stuurprogramma handmatig te installeren met behulp van deze connector.

De connector ondersteunt de Couchbase-versie hoger dan 6.0.

Vereisten

Als uw gegevensarchief zich in een on-premises netwerk, een Azure virtueel netwerk of Amazon Virtual Private Cloud bevindt, moet u een zelf-hostende Integration Runtime configureren om er verbinding mee te maken.

Als uw gegevensarchief een beheerde cloudgegevensservice is, kunt u de Azure Integration Runtime gebruiken. Als de toegang is beperkt tot IP-adressen die zijn goedgekeurd in de firewallregels, kunt u Azure Integration Runtime IP-adressen toevoegen aan de acceptatielijst.

U kunt ook de functie beheerde integratieruntime voor virtuele netwerken in Azure Data Factory gebruiken om toegang te krijgen tot het on-premises netwerk zonder een zelf-hostende Integration Runtime te installeren en te configureren.

Zie Strategieën voor gegevenstoegang voor meer informatie over de netwerkbeveiligingsmechanismen en -opties die door Data Factory worden ondersteund.

Aan de slag

Als u de kopieeractiviteit wilt uitvoeren met een pijplijn, kunt u een van de volgende hulpprogramma's of SDK's gebruiken:

Een gekoppelde service maken voor Couchbase met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service te maken voor Couchbase in de gebruikersinterface van de Azure-portal.

  1. Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en klik vervolgens op Nieuw:

  2. Zoek naar Couchbase en selecteer de Couchbase-connector.

    Schermopname van de Couchbase-connector.

  3. Configureer de servicedetails, test de verbinding en maak de nieuwe gekoppelde service.

    Schermopname van de gekoppelde serviceconfiguratie voor Couchbase.

Configuratiedetails van de connector

De volgende secties bevatten details over eigenschappen die worden gebruikt om Data Factory-entiteiten te definiëren die specifiek zijn voor Couchbase-connector.

Eigenschappen van gekoppelde service

De volgende eigenschappen worden ondersteund voor de gekoppelde Couchbase-service:

Eigenschap Beschrijving Vereist
type De eigenschap type moet worden ingesteld op: Couchbase Ja
connectionString Een ODBC-connection string om verbinding te maken met Couchbase.
U kunt ook de referentietekenreeks in Azure Key Vault plaatsen en de credString-configuratie uit de connection string halen. Raadpleeg de volgende voorbeelden en het artikel Opslagreferenties in Azure Key Vault voor meer informatie.		 Ja
connectVia De Integration Runtime dat moet worden gebruikt om verbinding te maken met de gegevensopslag. Meer informatie vindt u in de sectie Vereisten . Als dit niet is opgegeven, wordt de standaard-Azure Integration Runtime gebruikt. Nee

Voorbeeld:

{
    "name": "CouchbaseLinkedService",
    "properties": {
        "type": "Couchbase",
        "typeProperties": {
            "connectionString": "Server=<server>; Port=<port>;AuthMech=1;CredString=[{\"user\": \"JSmith\", \"pass\":\"access123\"}, {\"user\": \"Admin\", \"pass\":\"simba123\"}];"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Voorbeeld: referentietekenreeks opslaan in Azure Key Vault

{
    "name": "CouchbaseLinkedService",
    "properties": {
        "type": "Couchbase",
        "typeProperties": {
            "connectionString": "Server=<server>; Port=<port>;AuthMech=1;",
            "credString": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Eigenschappen van gegevensset

Zie het artikel gegevenssets voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van gegevenssets . Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de Couchbase-gegevensset.

Als u gegevens uit Couchbase wilt kopiëren, stelt u de typeeigenschap van de gegevensset in op CouchbaseTable. De volgende eigenschappen worden ondersteund:

Eigenschap Beschrijving Vereist
type De typeeigenschap van de gegevensset moet worden ingesteld op: CouchbaseTable Ja
tableName Naam van de tabel. Nee (als 'query' in de bron van de activiteit is opgegeven)

Voorbeeld

{
    "name": "CouchbaseDataset",
    "properties": {
        "type": "CouchbaseTable",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Couchbase linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Copy activity eigenschappen

Zie het artikel Pijplijnen voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van activiteiten. Deze sectie bevat een lijst met eigenschappen die worden ondersteund door couchbase-bron.

CouchbaseSource als bron

Als u gegevens uit Couchbase wilt kopiëren, stelt u het brontype in de kopieeractiviteit in op CouchbaseSource. De volgende eigenschappen worden ondersteund in de sectie bron van kopieeractiviteit:

Eigenschap Beschrijving Vereist
type De typeeigenschap van de bron van de kopieeractiviteit moet worden ingesteld op: CouchbaseSource Ja
zoekopdracht Gebruik de aangepaste SQL-query om gegevens te lezen. Voorbeeld: "SELECT * FROM MyTable". Nee (als 'tableName' in de gegevensset is opgegeven)

Voorbeeld:

"activities":[
    {
        "name": "CopyFromCouchbase",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Couchbase input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "CouchbaseSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Eigenschappen van opzoekactiviteit

Als u meer wilt weten over de eigenschappen, controleert u de lookup-activiteit.

Gerelateerde inhoud

Zie ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.

  • Last updated on