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

VZTAHUJE SE NA: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory v Microsoft Fabric je nová generace Azure Data Factory s jednodušší architekturou, integrovanou AI a novými funkcemi. Pokud s integrací dat začínáte, začněte Fabric Data Factory. Stávající úlohy ADF lze upgradovat na Fabric pro přístup k novým funkcím v oblastech datové vědy, analýz v reálném čase a vytváření sestav.

Důležité

Tento konektor je na konci fáze podpory. Doporučujeme migrovat na konektor ODBC instalací ovladače.

Tento článek popisuje, jak využitím kopírovací aktivity v pipeline Azure Data Factory nebo Synapse Analytics kopírovat data z Phoenixu. Vychází z článku přehled kopírovací aktivita, který představuje obecný přehled kopírovací aktivity.

Podporované funkce

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

Podporované funkce IR
aktivita Copy (zdroj/-) (1) (2)
Vyhledávací aktivita (1) (2)

(1) Azure Integration Runtime (2) Lokálně hostované 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č.

Požadavky

Pokud se vaše úložiště dat nachází uvnitř místní sítě, Azure virtuální sítě, nebo Amazon Virtual Private Cloud, musíte pro připojení nakonfigurovat self-hosted Integration Runtime.

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 Azure Integration Runtime.

Funkci managed virtual network Integration Runtime můžete také použít v Azure Data Factory pro přístup k místní síti bez nutnosti instalace a konfigurace místního prostředí Integration Runtime.

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.

Začínáme

K provedení kopírovací činnosti s datovým tokem můžete použít jeden z následujících nástrojů nebo sady SDK:

Vytvoření propojené služby s Phoenixem pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu s Phoenixem v uživatelském rozhraní portálu Azure.

  1. Přejděte na kartu Spravovat v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a potom klikněte na Nový:

  2. Vyhledejte Phoenix a vyberte konektor Phoenix.

    Snímek obrazovky konektoru Phoenix

  3. Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

    Snímek obrazovky s konfigurací propojené služby pro Phoenix

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 Phoenix.

Vlastnosti propojené služby

Pro propojenou službu Phoenix jsou podporovány následující vlastnosti:

Vlastnost Popis Povinné
typ Vlastnost typu musí být nastavena na: Phoenix. Ano
hostitel IP adresa nebo název hostitele serveru Phoenix. (to znamená 192.168.222.160) Ano
port Port TCP, který server Phoenix používá k naslouchání příchozím klientským připojením. Výchozí hodnota je 8765. Pokud se připojíte k Azure HDInsights, zadejte port 443. Ne
httpPath Částečná adresa URL odpovídající serveru Phoenix. (to znamená /gateway/sandbox/phoenix/version). Určete /hbasephoenix0 , jestli používáte cluster HDInsights. Ne
typ autentizace Ověřovací mechanismus použitý k připojení k serveru Phoenix.
Povolené hodnoty jsou: Anonymní, UsernameAndPassword, WindowsAzureHDInsightService
Ano
uživatelské jméno Uživatelské jméno použité pro připojení k serveru Phoenix. Ne
heslo Heslo odpovídající uživatelskému jménu. Označte toto pole jako SecureString pro jeho bezpečné uložení, nebo odkazujte na tajemství uložené v Azure Key Vault. Ne
enableSsl Určuje, jestli jsou připojení k serveru šifrovaná pomocí protokolu TLS. Výchozí hodnota je false. Ne
trustedCertPath Úplná cesta k souboru .pem obsahujícího důvěryhodné certifikáty certifikační autority pro ověření serveru při připojování přes protokol TLS. Tuto vlastnost lze nastavit pouze při použití protokolu TLS v místním prostředí IR. Výchozí hodnota je soubor cacerts.pem nainstalovaný s prostředím IR. Ne
useSystemTrustStore Určuje, jestli se má použít certifikát certifikační autority z úložiště důvěryhodnosti systému nebo ze zadaného souboru PEM. Výchozí hodnota je false. Ne
allowHostNameCNMismatch Určuje, jestli se má při připojování přes protokol TLS vyžadovat název certifikátu TLS/SSL vystavený certifikační autoritou, který odpovídá názvu hostitele serveru. Výchozí hodnota je false. Ne
povolitSamosignedServerCert Určuje, jestli chcete povolit certifikáty podepsané svým držitelem ze serveru. Výchozí hodnota je false. Ne
connectVia Integration Runtime pro připojení k úložišti dat. Další informace najdete v části Požadavky . Pokud není zadaný, použije výchozí Azure Integration Runtime. Ne

Poznámka:

Pokud váš cluster nepodporuje trvalou relaci, například HDInsight, explicitně přidejte index uzlu na konec nastavení cesty HTTP, například místo /hbasephoenix0 použijte /hbasephoenix.

Příklad:

{
    "name": "PhoenixLinkedService",
    "properties": {
        "type": "Phoenix",
        "typeProperties": {
            "host" : "<cluster>.azurehdinsight.net",
            "port" : "443",
            "httpPath" : "/hbasephoenix0",
            "authenticationType" : "WindowsAzureHDInsightService",
            "username" : "<username>",
            "password": {
                 "type": "SecureString",
                 "value": "<password>"
            }
        }
    }
}

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 Phoenix.

Pokud chcete kopírovat data z Phoenixu, nastavte vlastnost typu datové sady na PhoenixObject. Podporují se následující vlastnosti:

Vlastnost Popis Povinné
typ Vlastnost typu datové sady musí být nastavená na: PhoenixObject. Ano
schéma Název schématu Ne (pokud je zadán dotaz ve zdroji aktivity)
tabulka Název tabulky. Ne (pokud je zadán dotaz ve zdroji aktivity)
tableName Název tabulky se schématem Tato vlastnost je podporována pro zpětnou kompatibilitu. Používejte schema a table pro nové úlohy. Ne (pokud je zadán dotaz ve zdroji aktivity)

Příklad

{
    "name": "PhoenixDataset",
    "properties": {
        "type": "PhoenixObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Phoenix linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Vlastnosti kopírovací aktivity

Ú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 Phoenix.

Phoenix jako zdroj

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

Vlastnost Popis Povinné
typ Vlastnost typu zdroje aktivity kopírování musí být nastavena na: PhoenixSource Ano
dotaz Ke čtení dat použijte vlastní dotaz SQL. Například: "SELECT * FROM MyTable". Ne (pokud je v datové sadě zadán název tabulky)

Příklad:

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

Vlastnosti aktivity Lookup

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

Pro seznam úložišť dat podporovaných jako zdroje a výstupy kopírovací aktivitou, vizte podporovaná úložiště dat.