Kopírování dat z Vertica pomocí Azure Data Factory nebo Synapse Analytics

Článek
10/17/2024

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

Tento článek popisuje, jak pomocí aktivity kopírování v kanálu Služby Azure Data Factory nebo Synapse Analytics kopírovat data z Vertica. Vychází z článku s přehledem aktivity kopírování, který představuje obecný přehled aktivity kopírování.

Podporované funkce

Tento konektor Vertica je podporovaný pro následující funkce:

Podporované funkce	IR
aktivita Copy (zdroj/-)	(1) (pouze pro verzi 1.0) (2)
Aktivita Lookup	(1) (pouze pro verzi 1.0) (2)

(1) Prostředí Azure Integration Runtime (2) Místní prostředí Integration Runtime

Seznam úložišť dat podporovaných jako zdroje nebo jímky aktivitou kopírování najdete v tabulce Podporované úložiště dat.

Služba poskytuje integrovaný ovladač, který umožňuje připojení, takže pomocí tohoto konektoru nemusíte ručně instalovat žádný ovladač.

Pro verzi 2.0 (Preview) je nutné nainstalovat ovladač Vertica ODBC ručně. Pro verzi 1.0 poskytuje služba integrovaný ovladač, který umožňuje připojení, a proto nemusíte ručně instalovat žádný ovladač.

Požadavky

Pokud se vaše úložiště dat nachází uvnitř místní sítě, virtuální sítě Azure nebo amazonového privátního cloudu, musíte nakonfigurovat místní prostředí Integration Runtime pro připojení k němu. Pokud používáte verzi 2.0 (Preview), měla by být verze místního prostředí Integration Runtime 5.44.8984.1 nebo vyšší.

Další informace o mechanismech zabezpečení sítě a možnostech podporovaných službou Data Factory najdete v tématu Strategie přístupu k datům.

Pro verzi 1.0

Pokud je vaše úložiště dat spravovanou cloudovou datovou službou, můžete použít Azure Integration Runtime. Pokud je přístup omezený na IP adresy schválené v pravidlech brány firewall, můžete do seznamu povolených přidat IP adresy prostředí Azure Integration Runtime.

K přístupu k místní síti bez nutnosti instalace a konfigurace místního prostředí Integration Runtime můžete také použít funkci Runtime integrace spravované virtuální sítě ve službě Azure Data Factory.

Instalace ovladače Vertica ODBC pro verzi 2.0 (Preview)

Pokud chcete používat konektor Vertica s verzí 2.0 (Preview), nainstalujte ovladač Vertica ODBC na počítač s místním prostředím Integration Runtime pomocí následujícího postupu:

Stažení instalačního programu klienta Vertica pro ovladač ODBC z klientských ovladačů | OpenText™ Vertica™. Jako příklad vezměte instalaci systému Windows:
Otevřete stažený .exe a spusťte proces instalace. 
V seznamu komponent Vertica vyberte ovladač ODBC a pak spusťte instalaci výběrem možnosti Další .
Po úspěšném dokončení procesu instalace můžete přejít na start –> správce zdroje dat ODBC a potvrdit úspěšnou instalaci.

Začínáme

Kanál s aktivitou kopírování můžete vytvořit pomocí sady .NET SDK, Python SDK, Azure PowerShellu, rozhraní REST API nebo šablony Azure Resource Manageru. Podrobné pokyny k vytvoření kanálu s aktivitou kopírování najdete v aktivita Copy kurzu.

Vytvoření propojené služby pro Vertica pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu vertica v uživatelském rozhraní webu Azure Portal.

Přejděte na kartu Správa v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a pak klikněte na Nový:
- Azure Data Factory
- Azure Synapse
Vyhledejte Vertica a vyberte konektor Vertica.
Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

Podrobnosti konfigurace konektoru

Následující části obsahují podrobnosti o vlastnostech, které slouží k definování entit služby Data Factory specifických pro konektor Vertica.

Vlastnosti propojené služby

Pokud používáte verzi 2.0 (Preview), jsou pro propojenou službu Vertica podporované následující vlastnosti:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu musí být nastavena na: Vertica	Ano
server	Název nebo IP adresa serveru, ke kterému se chcete připojit.	Ano
port	Číslo portu naslouchacího procesu serveru.	Ne, výchozí hodnota je 5433
database	Název databáze Vertica.	Ano
Uid	ID uživatele, které se používá pro připojení k databázi.	Ano
Pwd	Heslo, které aplikace používá pro připojení k databázi.	Ano
version	Verze při výběru verze 2.0 (Preview) Hodnota je `2.0`.	Ano
connectVia	Prostředí Integration Runtime , které se má použít pro připojení k úložišti dat. Další informace najdete v části Požadavky . Můžete použít pouze místní prostředí Integration Runtime a jeho verze by měla být 5.44.8984.1 nebo vyšší.	No

Příklad:

{
    "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"
        }
    }
}

Příklad: Uložení hesla ve službě 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"
        }
    }
}

Pokud používáte verzi 1.0, jsou podporovány následující vlastnosti:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu musí být nastavena na: Vertica	Ano
připojovací řetězec	Rozhraní ODBC připojovací řetězec pro připojení k Vertica. Můžete také zadat heslo do služby Azure Key Vault a vytáhnout `pwd` konfiguraci z připojovací řetězec. Další podrobnosti najdete v následujících ukázkách a ukládání přihlašovacích údajů ve službě Azure Key Vault .	Ano
connectVia	Prostředí Integration Runtime , které se má použít pro připojení k úložišti dat. Další informace najdete v části Požadavky . Pokud není zadaný, použije výchozí prostředí Azure Integration Runtime.	No

Příklad:

{
    "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"
        }
    }
}

Vlastnosti datové sady

Úplný seznam oddílů a vlastností dostupných pro definování datových sad najdete v článku o datových sadách . Tato část obsahuje seznam vlastností podporovaných datovou sadou Vertica.

Chcete-li kopírovat data z Vertica, nastavte vlastnost typu datové sady na VerticaTable. Podporují se následující vlastnosti:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu datové sady musí být nastavená na: VerticaTable.	Ano
schema	Název schématu	Ne (pokud je zadán dotaz ve zdroji aktivity)
table	Název tabulky.	Ne (pokud je zadán dotaz ve zdroji aktivity)

Příklad

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

Vlastnosti aktivity kopírování

Úplný seznam oddílů a vlastností dostupných pro definování aktivit najdete v článku Pipelines . Tato část obsahuje seznam vlastností podporovaných zdrojem Vertica.

Vertica jako zdroj

Pokud chcete kopírovat data z Vertica, nastavte typ zdroje v aktivitě kopírování na VerticaSource. Ve zdrojové části aktivity kopírování jsou podporovány následující vlastnosti:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu zdroje aktivity kopírování musí být nastavena na: VerticaSource.	Ano
query	Ke čtení dat použijte vlastní dotaz SQL. Například: `"SELECT * FROM MyTable"`.	Ne (pokud je v datové sadě zadáno schéma+tabulka)

Příklad:

"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>"
            }
        }
    }
]

Vlastnosti aktivity vyhledávání

Podrobnosti o vlastnostech najdete v aktivitě Vyhledávání.

Upgrade verze Vertica

Tady jsou kroky, které vám pomůžou upgradovat verzi Vertica:

Nainstalujte ovladač Vertica ODBC podle kroků v části Požadavky.
Na stránce Upravit propojenou službu vyberte v části Verze 2.0 (Preview) a nakonfigurujte propojenou službu podle vlastností propojené služby.
Použijte místní prostředí Integration Runtime s verzí 5.44.8984.1 nebo vyšší. Prostředí Azure Integration Runtime nepodporuje verze 2.0 (Preview).

Seznam úložišť dat podporovaných jako zdroje a jímky aktivitou kopírování najdete v podporovaných úložištích dat.

Sdílet prostřednictvím

Kopírování dat z Vertica pomocí Azure Data Factory nebo Synapse Analytics

Podporované funkce

Požadavky

Pro verzi 1.0

Instalace ovladače Vertica ODBC pro verzi 2.0 (Preview)

Začínáme

Vytvoření propojené služby pro Vertica pomocí uživatelského rozhraní

Podrobnosti konfigurace konektoru

Vlastnosti propojené služby

Vlastnosti datové sady

Vlastnosti aktivity kopírování

Vertica jako zdroj

Vlastnosti aktivity vyhledávání

Upgrade verze Vertica

Váš názor

Další materiály

Sdílet prostřednictvím

Kopírování dat z Vertica pomocí Azure Data Factory nebo Synapse Analytics

Podporované funkce

Požadavky

Pro verzi 1.0

Instalace ovladače Vertica ODBC pro verzi 2.0 (Preview)

Začínáme

Vytvoření propojené služby pro Vertica pomocí uživatelského rozhraní

Podrobnosti konfigurace konektoru

Vlastnosti propojené služby

Vlastnosti datové sady

Vlastnosti aktivity kopírování

Vertica jako zdroj

Vlastnosti aktivity vyhledávání

Upgrade verze Vertica

Související obsah

Váš názor

Další materiály