Dela via

Kopiera data från Vertica med Hjälp av Azure Data Factory eller Synapse Analytics

  • Artikel

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

Den här artikeln beskriver hur du använder kopieringsaktiviteten i en Azure Data Factory- eller Synapse Analytics-pipeline för att kopiera data från Vertica. Den bygger på översiktsartikeln för kopieringsaktivitet som visar en allmän översikt över kopieringsaktiviteten.

Funktioner som stöds

Den här Vertica-anslutningsappen stöds för följande funktioner:

Funktioner som stöds IR
Kopieringsaktivitet (källa/-) (1) (endast för version 1.0) (2)
Sökningsaktivitet (1) (endast för version 1.0) (2)

(1) Azure Integration Runtime (2) Lokalt installerad integrationskörning

En lista över datalager som stöds som källor/mottagare av kopieringsaktiviteten finns i tabellen Datalager som stöds.

Tjänsten tillhandahåller en inbyggd drivrutin för att aktivera anslutningen. Därför behöver du inte installera någon drivrutin manuellt med den här anslutningsappen.

För version 2.0 (förhandsversion) måste du installera en Vertica ODBC-drivrutin manuellt. För version 1.0 tillhandahåller tjänsten en inbyggd drivrutin för att aktivera anslutningen. Därför behöver du inte installera någon drivrutin manuellt.

Förutsättningar

Om ditt datalager finns i ett lokalt nätverk, ett virtuellt Azure-nätverk eller Amazon Virtual Private Cloud måste du konfigurera en lokalt installerad integrationskörning för att ansluta till det. Om du använder version 2.0 (förhandsversion) ska din lokala integrationskörningsversion vara 5.44.8984.1 eller senare.

Mer information om de nätverkssäkerhetsmekanismer och alternativ som stöds av Data Factory finns i Strategier för dataåtkomst.

För version 1.0

Om ditt datalager är en hanterad molndatatjänst kan du använda Azure Integration Runtime. Om åtkomsten är begränsad till IP-adresser som är godkända i brandväggsreglerna kan du lägga till Azure Integration Runtime-IP-adresser i listan över tillåtna.

Du kan också använda funktionen för integrering av hanterade virtuella nätverk i Azure Data Factory för att få åtkomst till det lokala nätverket utan att installera och konfigurera en lokalt installerad integrationskörning.

Installera Vertica ODBC-drivrutinen för version 2.0 (förhandsversion)

Om du vill använda Vertica-anslutningsappen med version 2.0 (förhandsversion) installerar du Vertica ODBC-drivrutinen på datorn som kör integrationskörningen med egen värd genom att följa dessa steg:

  1. Ladda ned Vertica-klientkonfigurationen för ODBC-drivrutinen från klientdrivrutiner | OpenText™ Vertica™. Ta Installation av Windows-system som exempel:

    Skärmbild av ett exempel på installation av Windows-system.

  2. Öppna den nedladdade .exe för att påbörja installationsprocessen. 

    Skärmbild av installationsprocessen.

  3. Välj ODBC-drivrutin under Vertica-komponentlista och välj sedan Nästa för att starta installationen.

    Skärmbild av att välja ODBC-drivrutin.

  4. När installationsprocessen har slutförts kan du gå till Starta –> ODBC-administratör för datakälla för att bekräfta att installationen har slutförts.

    Skärmbild som bekräftar att installationen har slutförts.

Komma igång

Du kan skapa en pipeline med kopieringsaktivitet med hjälp av .NET SDK, Python SDK, Azure PowerShell, REST API eller Azure Resource Manager-mall. Stegvisa instruktioner för att skapa en pipeline med en kopieringsaktivitet finns i Självstudie om kopieringsaktivitet.

Skapa en länkad tjänst till Vertica med hjälp av användargränssnittet

Använd följande steg för att skapa en länkad tjänst till Vertica i azure-portalens användargränssnitt.

  1. Bläddra till fliken Hantera i Din Azure Data Factory- eller Synapse-arbetsyta och välj Länkade tjänster och klicka sedan på Ny:

  2. Sök efter Vertica och välj Vertica-anslutningsappen.

    Skärmbild av Vertica-anslutningsappen.

  3. Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.

    Skärmbild av konfiguration av länkad tjänst för Vertica.

Konfigurationsinformation för anslutningsprogram

Följande avsnitt innehåller information om egenskaper som används för att definiera Data Factory-entiteter som är specifika för Vertica-anslutningsprogrammet.

Länkade tjänstegenskaper

Om du använder version 2.0 (förhandsversion) stöds följande egenskaper för Vertica-länkad tjänst:

Property Beskrivning Obligatoriskt
type Typegenskapen måste vara inställd på: Vertica Ja
server Namnet eller IP-adressen för den server som du vill ansluta till. Ja
port Serverlyssnarens portnummer. Nej, standardvärdet är 5433
database Namnet på Vertica-databasen. Ja
uid Användar-ID:t som används för att ansluta till databasen. Ja
Pwd Lösenordet som programmet använder för att ansluta till databasen. Ja
version Versionen när du väljer version 2.0 (förhandsversion). Värdet är 2.0. Ja
connectVia Integration Runtime som ska användas för att ansluta till datalagret. Läs mer i avsnittet Förutsättningar . Du kan bara använda den lokalt installerade integrationskörningen och dess version ska vara 5.44.8984.1 eller senare. Nej

Exempel:

{
    "name": "VerticaLinkedService",
    "properties": {
        "type": "Vertica",
        "version": "2.0",
        "typeProperties": {
            "server": "<server>",
            "port": 5433,
            "uid": "<username>",
            "database": "<database>",
            "pwd": {
                "type": "SecureString",
                "value": "<password>"
             }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exempel: Lagra lösenord i Azure Key Vault

{
    "name": "VerticaLinkedService",
    "properties": {
        "type": "Vertica",
        "version": "2.0",
        "typeProperties": {
            "server": "<server>",
            "port": 5433,
            "uid": "<username>",
            "database": "<database>",
            "pwd": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Om du använder version 1.0 stöds följande egenskaper:

Property Beskrivning Obligatoriskt
type Typegenskapen måste vara inställd på: Vertica Ja
connectionString En ODBC-niska veze för att ansluta till Vertica.
Du kan också lägga till lösenord i Azure Key Vault och hämta konfigurationen pwd från niska veze. Mer information finns i följande exempel och artikeln Lagra autentiseringsuppgifter i Azure Key Vault .		 Ja
connectVia Integration Runtime som ska användas för att ansluta till datalagret. Läs mer i avsnittet Förutsättningar . Om den inte anges använder den standardkörningen för Azure-integrering. Nej

Exempel:

{
    "name": "VerticaLinkedService",
    "properties": {
        "type": "Vertica",
        "typeProperties": {
            "connectionString": "Server=<server>;Port=<port>;Database=<database>;UID=<user name>;PWD=<password>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Egenskaper för datauppsättning

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i artikeln datauppsättningar . Det här avsnittet innehåller en lista över egenskaper som stöds av Vertica-datauppsättningen.

Om du vill kopiera data från Vertica anger du datauppsättningens typegenskap till VerticaTable. Följande egenskaper stöds:

Property Beskrivning Obligatoriskt
type Typegenskapen för datamängden måste anges till: VerticaTable Ja
schema Namnet på schemat. Nej (om "fråga" i aktivitetskällan har angetts)
table Tabellens namn. Nej (om "fråga" i aktivitetskällan har angetts)

Exempel

{
    "name": "VerticaDataset",
    "properties": {
        "type": "VerticaTable",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Vertica linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Kopiera egenskaper för aktivitet

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i artikeln Pipelines . Det här avsnittet innehåller en lista över egenskaper som stöds av Vertica-källan.

Vertica som källa

Om du vill kopiera data från Vertica anger du källtypen i kopieringsaktiviteten till VerticaSource. Följande egenskaper stöds i avsnittet kopieringsaktivitetskälla:

Property Beskrivning Obligatoriskt
type Typegenskapen för kopieringsaktivitetskällan måste anges till: VerticaSource Ja
query Använd den anpassade SQL-frågan för att läsa data. Exempel: "SELECT * FROM MyTable". Nej (om "schema+table" i datamängden har angetts)

Exempel:

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

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

Uppgradera Vertica-versionen

Här följer steg som hjälper dig att uppgradera din Vertica-version:

  1. Installera en Vertica ODBC-drivrutin genom att följa stegen i Krav.
  2. På sidan Redigera länkad tjänst väljer du 2.0 (förhandsversion) under Version och konfigurerar den länkade tjänsten genom att referera till Egenskaper för länkad tjänst.
  3. Tillämpa en lokalt installerad integrationskörning med version 5.44.8984.1 eller senare. Azure Integration Runtime stöds inte av version 2.0 (förhandsversion).

Relaterat innehåll

En lista över datalager som stöds som källor och mottagare av kopieringsaktiviteten finns i datalager som stöds.