Adatok másolása az Oracle-ből és az Oracle-be az Azure Data Factory vagy az Azure Synapse Analytics használatával

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk azt ismerteti, hogyan használhatja a másolási tevékenységet az Azure Data Factoryben adatok Oracle-adatbázisból és az oracle-adatbázisba való másolásához. A másolási tevékenység áttekintésére épül.

Fontos

Az Oracle-összekötő 2.0-s verziója továbbfejlesztett natív Oracle-támogatást biztosít. Ha az Oracle-összekötő 1.0-s verzióját használja a megoldásban, frissítse az Oracle-összekötőt , mivel az 1.0-s verzió a támogatás végén van. A folyamat 2026. március 31. után meghiúsul. Ebben a szakaszban a 2.0-s és az 1.0-s verzió közötti különbségről olvashat.

Támogatott képességek

Ez az Oracle-összekötő a következő képességeket támogatja:

Támogatott képességek	integrációs modul
Másolási művelet (forrás/tároló)	(1) (2)
Keresési tevékenység	(1) (2)
Szkripttevékenység	(1) (2)

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

A másolási tevékenység által forrásként vagy fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

Ez az Oracle-összekötő a következőket támogatja:

• Egy Oracle-adatbázis következő verziói a 2.0-s verzióhoz:
  • Oracle Database 19c és újabb
  • Oracle Database 18c és újabb
  • Oracle Database 12c és újabb
  • Oracle Database 11g vagy újabb
• Az Oracle-adatbázis 1.0-s verziójának következő verziói:
  • Oracle 19c R1 (19.1) és újabb
  • Oracle 18c R1 (18.1) és újabb
  • Oracle 12c R1 (12.1) és újabb
  • Oracle 11g R1 (11.1) és újabb
  • Oracle 10g R1 (10.1) és újabb
  • Oracle 9i R2 (9.2) és újabb
  • Oracle 8i R3 (8.1.7) és újabb
  • Oracle Database Cloud Exadata Service
• Párhuzamos másolás Oracle-forrásból. A részletekért tekintse meg az Oracle párhuzamos másolat szakaszát.

Feljegyzés

Az Oracle proxykiszolgálója nem támogatott.

Előfeltételek

Ha az adattár helyszíni hálózaton, Azure-beli virtuális hálózaton vagy Amazon Virtual Private Cloudon belül található, konfigurálnia kell egy saját üzemeltetésű integrációs modult a csatlakozáshoz.

Ha az adattár felügyelt felhőalapú adatszolgáltatás, használhatja az Azure Integration Runtime-ot. Ha a hozzáférés a tűzfalszabályokban jóváhagyott IP-címekre korlátozódik, hozzáadhat azure integration runtime IP-eket az engedélyezési listához.

Az Azure Data Factory felügyelt virtuális hálózati integrációs moduljával is elérheti a helyszíni hálózatot anélkül, hogy saját üzemeltetésű integrációs modult telepítene és konfigurálna.

A Data Factory által támogatott hálózati biztonsági mechanizmusokkal és lehetőségekkel kapcsolatos további információkért lásd az adathozzáférési stratégiákat.

Az integrációs modul beépített Oracle-illesztőprogramot biztosít. Ezért nem kell manuálisan telepítenie egy illesztőprogramot, amikor adatokat másol az Oracle-ből és az Oracle-be.

Első lépések

A másolási tevékenység folyamattal való végrehajtásához használja az alábbi eszközök vagy SDK-k egyikét:

• Adatok másolása eszköz
• Azure Portál
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure Resource Manager-sablon

Társított szolgáltatás létrehozása az Oracle-hez felhasználói felülettel

Az alábbi lépések végrehajtásával hozzon létre egy társított szolgáltatást az Oracle-hez az Azure Portal felhasználói felületén.

1. Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

   Azure Data Factory

   

   Azure Synapse

   

2. Keresse meg az Oracle-t, és válassza ki az Oracle-összekötőt.

   

3. Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

   

Az összekötő konfigurációjának részletei

Az alábbi szakaszok az Oracle-összekötőre jellemző entitások meghatározásához használt tulajdonságok részleteit ismertetik.

Társított szolgáltatás tulajdonságai

Az Oracle-összekötő 2.0-s verziója támogatja a TLS 1.3-at. Ebben a szakaszban tájékozódhat arról, hogyan frissítheti az Oracle-összekötő verzióját az 1.0-s verzióról. A tulajdonság részleteiért tekintse meg a megfelelő szakaszokat.

• 2.0-s verzió
• 1.0-s verzió

2.0-s verzió

Az Oracle társított szolgáltatás a következő tulajdonságokat támogatja a 2.0-s verzió alkalmazásakor:

Ingatlan	Leírás	Kötelező
típus	A típustulajdonságot Oracle értékre kell állítani.	Igen
verzió	A megadott verzió. Az érték 2.0.	Igen
kiszolgáló	Annak az Oracle-adatbázisnak a helye, amelyhez csatlakozni szeretne. A beállításhoz tekintse meg a kiszolgálótulajdonság-konfigurációt .	Igen
hitelesítési típus	Hitelesítési típus az Oracle-adatbázishoz való csatlakozáshoz. Most már csak az egyszerű hitelesítés támogatott.	Igen
felhasználónév	Az Oracle-adatbázis felhasználóneve.	Igen
jelszó	Az Oracle-adatbázis jelszava. Jelölje meg ezt a mezőt SecureStringként a biztonságos tároláshoz. Hivatkozhat az Azure Key Vaultban tárolt titkos kódokra is.	Igen
connectVia	Az adattárhoz való csatlakozáshoz használt futtatókörnyezet. További információ az Előfeltételek szakaszból. Ha nincs megadva, a rendszer az alapértelmezett Azure Integration Runtime-t használja.	Nem

A csatolt szolgáltatásban az esettől függően a következő további kapcsolati tulajdonságokat állíthatja be.

Ingatlan	Leírás	Kötelező	Alapértelmezett érték
titkosítási kliens	Megadja a titkosítási ügyfél viselkedését. A támogatott értékek a következőkaccepted: , rejectedrequestedvagy required. Típus: karakterlánc	Nem	required
titkosításiTípusokÜgyfél	Megadja az ügyfél által használható titkosítási algoritmusokat. A támogatott értékek a következőkAES128: , AES192, AES256, 3DES1123DES168. Típus: karakterlánc	Nem	(AES256)
cryptoChecksumClient	Megadja a kívánt adatintegritási viselkedést, amikor az ügyfél egy kiszolgálóhoz csatlakozik. A támogatott értékek a következőkaccepted: , rejectedrequestedvagy required. Típus: karakterlánc	Nem	required
cryptoChecksumTypesClient	Megadja az ügyfél által használható titkosítási ellenőrzőösszeg-algoritmusokat. A támogatott értékek a következőkSHA1: , SHA256, SHA384SHA512. Típus: karakterlánc	Nem	(SHA512)
kezdetiLobLekérésMéret	Meghatározza azt az összeget, amit a forrás kezdetben lekér a LOB oszlopokhoz. Típus: int	Nem	0
Adatlekérés mérete	Megadja, hogy az illesztőprogram hány bájtot foglal le az adatok lekéréséhez egy adatbázis-körúton. Típus: int	Nem	10 MB
utasítás gyorsítótár méret	Az egyes adatbázis-kapcsolatokhoz gyorsítótárazandó kurzorok vagy utasítások számát adja meg. Típus: int	Nem	0
inicializálási karakterlánc	A munkamenet-beállítások kezeléséhez közvetlenül az adatbázishoz való csatlakozás után kiadott parancsot adja meg. Típus: karakterlánc	Nem	null
Engedélyezze a tömeges betöltést	Megadja, hogy tömeges másolást vagy kötegelt beszúrást használjon-e az adatok adatbázisba való betöltésekor. Típus: logikai	Nem	igaz
supportV1Adattípusok	Megadja, hogy az 1.0-s verziójú adattípus-leképezéseket használja-e. Ne állítsa ezt igaz értékre, hacsak nem szeretné megőrizni az 1.0-s verzió adattípus-leképezéseivel való kompatibilitást. Típus: logikai	Nem, ez a tulajdonság csak visszamenőleges kompatibilitást biztosít	hamis
fetchTswtzAsTimestamp	Azt határozza meg, hogy a vezető az IDŐBÉLYEG IDŐZÓNÁVAL adattípusú oszlop értékét DateTime vagy sztring formátumban adja-e vissza. Ez a beállítás figyelmen kívül lesz hagyva, ha a supportV1DataTypes nem igaz. Típus: logikai	Nem, ez a tulajdonság csak visszamenőleges kompatibilitást biztosít	igaz

Példa

{
    "name": "OracleLinkedService",
    "properties": {
        "type": "Oracle",
        "version": "2.0",
        "typeProperties": {
            "server": "<server name>", 
            "username": "<user name>", 
            "password": "<password>", 
            "authenticationType": "<authentication type>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Példa: jelszó tárolása az Azure Key Vaultban

{
    "name": "OracleLinkedService",
    "properties": {
        "type": "Oracle",
        "version": "2.0",
        "typeProperties": {
            "server": "<server name>", 
            "username": "<user name>", 
            "authenticationType": "<authentication type>",
            "password": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

server tulajdonságkonfiguráció

Tulajdonság esetén server a következő három formátum egyikében adhatja meg:

Formátum	Példa
Csatlakozó leíró	(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=sales-server)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=sales.us.acme.com)))
Easy Connect (Plusz) elnevezés	salesserver1:1521/sales.us.example.com
Oracle Net Services Name (TNS Alias) ( csak a saját üzemeltetésű integrációs modulhoz)	értékesítés

Az alábbi lista a támogatott paramétereket mutatja server. Ha olyan paramétereket használ, amelyek nem szerepelnek a következő listában, a kapcsolat meghiúsul.

• Az Azure integrációs modul használatakor:

  HÁZIGAZDA
  Kikötő
  PROTOKOLL
  SERVICE_NAME
  SID
  PÉLDÁNY_NÉV
  SZERVER
  Csatlakozási időkorlát
  ÚJRAKISÉRLETEK_SZÁMA
  ÚJRAKÍSÉRLET_KÉSLELTETÉS
  SSL_VERSION
  SSL_SZERVER_DN_EGYEZÉS
  SSL_SERVER_CERT_DN

• A saját üzemeltetésű integrációs modul használatakor:

  HÁZIGAZDA
  Kikötő
  PROTOKOLL
  ENGEDÉLYEZ
  Lejárati idő
  ÁTKAPCSOLÁS
  Terheléselosztás
  fogadó puffer mérete
  SDU
  SEND_BUF_SIZE (Küldési puffer méret)
  forrásútvonal
  Szolgáltatás típusa
  COLOCATION_TAG
  CSATLAKOZÁS_AZONOSÍTÓ_ELŐTAG
  átkapcsolási mód
  GLOBAL_NAME
  HS
  PÉLDÁNY_NÉV
  medencehatár
  Kapcsolat-Osztály Pool (if applicable based on the context).
  POOL_NAME
  Medence tisztasága
  RDB_ADATBÁZIS
  szeletelési_kulcs
  SHARDING_KEY_ID
  SUPER_SHARDING_KEY – szuper osztókulcs
  SZERVER
  SERVICE_NAME
  SID
  Alagút szolgáltatás neve
  SSL_KLIENS_HITelesítés
  SSL_TANÚSÍTVÁNY_ALIAS
  SSL_TANÚSÍTVÁNY_UJJLENYOMAT
  SSL_VERSION
  SSL_SZERVER_DN_EGYEZÉS
  SSL_SERVER_CERT_DN
  PÉNZTÁRCA_HELYZET
  Csatlakozási időkorlát
  ÚJRAKISÉRLETEK_SZÁMA
  ÚJRAKÍSÉRLET_KÉSLELTETÉS
  TRANSPORT_KAPCSOLAT_LEJÁRATI_IDŐ
  RECV_TIMEOUT
  TÖMÖRÍTÉS
  tömörítési szintek

1.0-s verzió

Az Oracle társított szolgáltatás az alábbi tulajdonságokat támogatja az 1.0-s verzió alkalmazásakor:

Ingatlan	Leírás	Kötelező
típus	A típustulajdonságot Oracle értékre kell állítani.	Igen
csatlakozási karakterlánc	Megadja az Oracle Database-példányhoz való csatlakozáshoz szükséges információkat. Jelszót is elhelyezhet az Azure Key Vaultban, és lekérheti a password konfigurációt a kapcsolati láncból. További részletekért tekintse meg az alábbi mintákat és a hitelesítő adatok tárolását az Azure Key Vaultban . Támogatott kapcsolattípus: Az Oracle SID vagy az Oracle szolgáltatásnév használatával azonosíthatja az adatbázist: - Ha SID-et használ: Host=<host>;Port=<port>;Sid=<sid>;User Id=<username>;Password=<password>; - Ha a szolgáltatásnevet használja: Host=<host>;Port=<port>;ServiceName=<servicename>;User Id=<username>;Password=<password>; A speciális Oracle natív kapcsolati lehetőségekhez választhat, hogy hozzáad egy bejegyzést a TNSNAMES.ORA-fájlban azon a gépen, amelyen a saját üzemeltetésű integrációs modul telepítve van, és az Oracle összekapcsolt szolgáltatásban válassza ki az Oracle szolgáltatásnév kapcsolattípust és konfigurálja a megfelelő szolgáltatásnevet.	Igen
connectVia	Az adattárhoz való csatlakozáshoz használt futtatókörnyezet. További információ az Előfeltételek szakaszból. Ha nincs megadva, a rendszer az alapértelmezett Azure Integration Runtime-t használja.	Nem

Tipp.

Ha az "ORA-01025: UPI paraméter kívül esik a tartományon" hibaüzenet jelenik meg, és az Oracle-verzió 8i, adja hozzá a WireProtocolMode=1 elemet a kapcsolati sztringhez. Ezután próbálkozzon újra.

Ha több Oracle példány áll rendelkezésére az automatikus átváltási forgatókönyvhöz, létrehozhat egy Oracle kapcsolati szolgáltatást, és kitöltheti az elsődleges gazdagép, port, felhasználónév, jelszó stb. adatait. Adjon hozzá egy új "további kapcsolódási tulajdonságot", a tulajdonság neve legyen AlternateServers, az érték pedig (HostName=<secondary host>:PortNumber=<secondary port>:ServiceName=<secondary service name>) – ne hagyja ki a zárójeleket, és figyeljen a kettőspontokra (:), mint elválasztóra. A másodlagos kiszolgálók alábbi értéke például két alternatív adatbázis-kiszolgálót határoz meg a kapcsolat feladatátvételéhez: (HostName=AccountingOracleServer:PortNumber=1521:SID=Accounting,HostName=255.201.11.24:PortNumber=1522:ServiceName=ABackup.NA.MyCompany).

Az esetének megfelelően további kapcsolati tulajdonságokat állíthat be a kapcsolati sztringben.

Ingatlan	Leírás	Megengedett értékek
Tömbök megjelenítése	Az összekötő által beolvasható bájtok száma egyetlen hálózati menetben. Például. ArraySize=‭10485760‬ A nagyobb értékek növelik az átviteli sebességet azáltal, hogy csökkentik az adatok beolvasásának számát a hálózaton. A kisebb értékek növelik a válaszidőt, mivel kevesebb késés vár a kiszolgálóra az adatok továbbítására.	1 és 4294967296 közötti egész szám (4 GB). Az alapértelmezett érték 60000. Az 1 érték nem határozza meg a bájtok számát, hanem pontosan egy adatsorhoz tartozó helyet jelöl.

Az Oracle-kapcsolat titkosításának engedélyezéséhez két lehetősége van:

• A Triple-DES Encryption (3DES) és az Advanced Encryption Standard (AES) használatához az Oracle kiszolgálóoldalán lépjen az Oracle Advanced Security (OAS) szolgáltatáshoz, és konfigurálja a titkosítási beállításokat. További részletekért tekintse meg az Oracle dokumentációját. Az Oracle Application Development Framework (ADF) csatlakozója automatikusan egyeztet egy titkosítási módszert, hogy az OAS-ben konfigurált módszert használja az Oracle-kapcsolat létrehozásakor.

• A TLS használatához állítsa be truststore az SSL-kiszolgáló hitelesítését az alábbi három módszer egyikének alkalmazásával:

  • 1. módszer (ajánlott):

    1. Telepítse a TLS/SSL-tanúsítványt a helyi tanúsítványtárolóba való importálással. A beépített Oracle-illesztőprogram képes betölteni a szükséges tanúsítványt a tanúsítványtárolóból.

    2. A szolgáltatásban konfigurálja az Oracle kapcsolati sztringet a EncryptionMethod=1 következővel:.

  • Módszer 2:

    1. Kérje le a TLS/SSL-tanúsítvány adatait. Szerezze meg a DER-kódolású vagy PEM-kódolású tanúsítványadatait a TLS/SSL-tanúsítványáról.

       openssl x509 -inform (DER|PEM) -in [Full Path to the DER/PEM Certificate including the name of the DER/PEM Certificate] -text
       

    2. A szolgáltatásban konfigurálja az Oracle kapcsolati sztringet a EncryptionMethod=1 és a megfelelő TrustStore értéket. Például: Host=<host>;Port=<port>;Sid=<sid>;User Id=<username>;Password=<password>;EncryptionMethod=1;TrustStore= data:// -----BEGIN CERTIFICATE-----<certificate content>-----END CERTIFICATE-----

       Feljegyzés

       • A mező értékét TrustStore előtaggal data://kell megadni.
       • Több tanúsítvány tartalmának megadásakor adja meg az egyes tanúsítványok -----BEGIN CERTIFICATE----------END CERTIFICATE-----tartalmát. A kötőjelek (-----) számának mind BEGIN CERTIFICATE előtt, mind END CERTIFICATE után meg kell egyeznie. Példa:
         -----BEGIN CERTIFICATE-----<certificate content 1>-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----<certificate content 2>-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----<certificate content 3>-----END CERTIFICATE-----
       • A TrustStore mező legfeljebb 8192 karakter hosszúságú tartalmat támogat.

  • 3. Módszer

    1. Hozza létre a truststore fájlt erős titkosítókkal, például az AES256-tal.

       openssl pkcs12 -in [Full Path to the DER/PEM Certificate including the name of the DER/PEM Certificate] -out [Path and name of TrustStore] -passout pass:[Keystore PWD] -keypbe AES-256-CBC -certpbe AES-256-CBC -nokeys -export
       

    2. Helyezze a truststore fájlt a saját üzemeltetésű integrációs futtatókörnyezeti gépre. Tegyük fel például a fájlt a következő helyre C:\MyTrustStoreFile: .

    3. A szolgáltatásban konfigurálja az Oracle kapcsolati karakterláncot a EncryptionMethod=1 és a megfelelő TrustStore/TrustStorePassword értékkel. Például: Host=<host>;Port=<port>;Sid=<sid>;User Id=<username>;Password=<password>;EncryptionMethod=1;TrustStore=C:\\MyTrustStoreFile;TrustStorePassword=<trust_store_password>.

Példa

{
    "name": "OracleLinkedService",
    "properties": {
        "type": "Oracle",
        "typeProperties": {
            "connectionString": "Host=<host>;Port=<port>;Sid=<sid>;User Id=<username>;Password=<password>;"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Példa: jelszó tárolása az Azure Key Vaultban

{
    "name": "OracleLinkedService",
    "properties": {
        "type": "Oracle",
        "typeProperties": {
            "connectionString": "Host=<host>;Port=<port>;Sid=<sid>;User Id=<username>;",
            "password": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Adathalmaz tulajdonságai

Ez a szakasz az Oracle-adatkészlet által támogatott tulajdonságok listáját tartalmazza. Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az Adathalmazok című témakörben találja.

Ha adatokat szeretne másolni az Oracle-ből és az Oracle-be, állítsa az adathalmaz típustulajdonságát a következőre OracleTable: . A következő tulajdonságok támogatottak.

Ingatlan	Leírás	Kötelező
típus	Az adathalmaz típustulajdonságának a következőnek kell lennie OracleTable: .	Igen
séma	A séma neve.	Nem a forrásra, igen a nyelőre
tábla	A tábla/nézet neve.	Nem a forrásra, igen a nyelőre
táblázatNeve	A táblázat/nézet neve a séma megadásával. Ez a tulajdonság támogatja a visszamenőleges kompatibilitást. Új számítási feladatokhoz használja schema és table.	Nem a forrásra, igen a nyelőre

Példa

{
    "name": "OracleDataset",
    "properties":
    {
        "type": "OracleTable",
        "schema": [],
        "typeProperties": {
            "schema": "<schema_name>",
            "table": "<table_name>"
        },
        "linkedServiceName": {
            "referenceName": "<Oracle linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Másolási tevékenység tulajdonságai

Ez a szakasz az Oracle-forrás és fogadó által támogatott tulajdonságok listáját tartalmazza. A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című témakörben találja.

Oracle mint forrás

Tipp.

Ha hatékonyan szeretne adatokat betölteni az Oracle-ből adatparticionálással, további információt az Oracle párhuzamos másolásáról tudhat meg.

Ha adatokat szeretne másolni az Oracle-ből, állítsa a másolási tevékenység forrástípusát a következőre OracleSource: . A másolási tevékenység forrás szakaszában az alábbi tulajdonságok támogatottak.

Ingatlan	Leírás	Kötelező
típus	A másolási tevékenység forrásának típustulajdonságát be kell állítani OracleSource.	Igen
oracleReaderQuery	Az adatok olvasásához használja az egyéni SQL-lekérdezést. Például: "SELECT * FROM MyTable". Vegye figyelembe, hogy a lekérdezés nem végződhet pontosvesszővel (;). Ha engedélyezi a particionált terhelést, csatlakoztatnia kell a megfelelő beépített partícióparamétereket a lekérdezésben. Példákért lásd az Oracle párhuzamos másolat című részt.	Nem
decimálisrólEgészreKonvertálás	A nulla vagy meghatározatlan skálázású Oracle NUMBER típus a megfelelő egész számmá lesz konvertálva. Az engedélyezett értékek igazak és hamisak (alapértelmezett). Ha az Oracle 2.0-s verzióját használja, ez a tulajdonság csak akkor lesz engedélyezve, ha a supportV1DataTypes értéke igaz.	Nem
partíciós beállítások	Az Oracle-ből való adatbetöltéshez használt adatparticionálási beállításokat adja meg. Az engedélyezett értékek a következők: Nincs (alapértelmezett), PhysicalPartitionsOfTable és DynamicRange. Ha egy partíciós beállítás engedélyezve van (vagyis nem None), az Oracle-adatbázisból egyidejűleg betöltendő adatok párhuzamossági fokát a parallelCopies másolási tevékenység beállítása szabályozza.	Nem
partícióbeállítások	Adja meg az adatparticionálás beállításainak csoportját. Akkor alkalmazható, ha a partíciós beállítás nem None.	Nem
partitionNames	A másolandó fizikai partíciók listája. Akkor alkalmazandó, amikor a partíció opció a PhysicalPartitionsOfTable. Ha lekérdezést használ a forrásadatok lekéréséhez, a WHERE záradékban kapcsoljon ?AdfTabularPartitionName be. Példaként tekintse meg az Oracle párhuzamos másolata szakaszt.	Nem
partícióoszlopNév	Adja meg a forrásoszlop nevét egész számtípusban , amelyet a párhuzamos másolás tartományparticionálása használ. Ha nincs megadva, a rendszer automatikusan észleli a tábla elsődleges kulcsát, és partícióoszlopként használja. Akkor alkalmazandó, amikor a partíció opció a DynamicRange. Ha lekérdezést használ a forrásadatok lekéréséhez, a WHERE záradékban kapcsoljon ?AdfRangePartitionColumnName be. Példaként tekintse meg az Oracle párhuzamos másolata szakaszt.	Nem
partíció felső határa	A partícióoszlop maximális értéke az adatok kimásolásához. Akkor alkalmazandó, amikor a partíció opció a DynamicRange. Ha lekérdezést használ a forrásadatok lekéréséhez, a WHERE záradékban kapcsoljon ?AdfRangePartitionUpbound be. Példaként tekintse meg az Oracle párhuzamos másolata szakaszt.	Nem
partíció alsó határa	Az adatok másolásához szükséges partícióoszlop minimális értéke. Akkor alkalmazandó, amikor a partíció opció a DynamicRange. Ha lekérdezést használ a forrásadatok lekéréséhez, a WHERE záradékban kapcsoljon ?AdfRangePartitionLowbound be. Példaként tekintse meg az Oracle párhuzamos másolata szakaszt.	Nem
számPontosság	Adja meg a jelentős tizedesjegyek maximális számát. Az engedélyezett értékek 1 és 256 között mozognak. Alapértelmezés szerint 256, ha nincs megadva. Ez a tulajdonság az Oracle 2.0-s verziójában támogatott. Csak azokra a SZÁMtípusokra vonatkozik, amelyek nem rendelkeznek az Oracle-adatbázisban explicit módon definiált pontossággal és skálázással. Akkor állítható be, ha supportV1DataTypes nem true. Ha saját üzemeltetésű integrációs modult használ, annak verziója 5.56-os vagy újabb lesz.	Nem
számskála	Adja meg a tizedesvessző utáni számjegyek számát. Az engedélyezett értékek 0 és 130 közöttiek lehetnek, és kisebbnek vagy egyenlőnek kell lenniük a pontosságnál. Alapértelmezés szerint 130, ha nincs megadva. Ez a tulajdonság az Oracle 2.0-s verziójában támogatott. Csak azokra a SZÁMtípusokra vonatkozik, amelyek nem rendelkeznek az Oracle-adatbázisban explicit módon definiált pontossággal és skálázással. Akkor állítható be, ha supportV1DataTypes nem true. Ha saját üzemeltetésű integrációs modult használ, annak verziója 5.56-os vagy újabb lesz.	Nem

Példa: adatok másolása partíció nélküli egyszerű lekérdezéssel

"activities":[
    {
        "name": "CopyFromOracle",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Oracle input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "OracleSource",
                "convertDecimalToInteger": false,
                "oracleReaderQuery": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Oracle mint fogadó

Ha adatokat szeretne az Oracle-be másolni, állítsa a fogadó típusát a másolási tevékenységben a következőre OracleSink: . A másolási tevékenység fogadó szakaszában az alábbi tulajdonságok támogatottak.

Ingatlan	Leírás	Kötelező
típus	A másolási tevékenység fogadójának típustulajdonságát a következőre kell állítani OracleSink: .	Igen
writeBatchSize	A pufferméret elérésekor writeBatchSizeadatokat szúr be az SQL-táblába. Az engedélyezett értékek egész számok (sorok száma).	Nem (az alapértelmezett érték 10 000)
writeBatchTimeout	A köteg beszúrási műveletének várakozási ideje, mielőtt lejár az időkorlát. Az engedélyezett értékek időbélyegek. Ilyen például a 00:30:00 (30 perc).	Nem
preCopyScript	Adjon meg egy SQL-lekérdezést a futtatandó másolási tevékenységhez, mielőtt adatokat írna az Oracle-be minden futtatás során. Ezzel a tulajdonságkal törölheti az előre betöltött adatokat.	Nem
maximálisEgyidejűKapcsolatok	Az adattárhoz a tevékenység futtatása során létrehozott egyidejű kapcsolatok felső korlátja. Csak akkor adjon meg értéket, ha korlátozni szeretné az egyidejű kapcsolatokat.	Nem

Példa

"activities":[
    {
        "name": "CopyToOracle",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<Oracle output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "OracleSink"
            }
        }
    }
]

Párhuzamos másolás az Oracle-ből

Az Oracle-összekötő beépített adatparticionálást biztosít az adatok oracle-ből való párhuzamos másolásához. Az adatparticionálási beállításokat a másolási tevékenység Forrás lapján találja.

Ha engedélyezi a particionált másolást, a szolgáltatás párhuzamos lekérdezéseket futtat az Oracle-forráson az adatok partíciók szerinti betöltéséhez. A másolási parallelCopies tevékenység beállításai szabályozzák a párhuzamos feldolgozási szintet. Ha például négyre van állítva parallelCopies , a szolgáltatás egyszerre generál és futtat négy lekérdezést a megadott partícióbeállítás és beállítások alapján, és mindegyik lekérdezés lekéri az adatok egy részét az Oracle-adatbázisból.

Javasoljuk, hogy engedélyezze a párhuzamos másolást adatparticionálással, különösen akkor, ha nagy mennyiségű adatot tölt be az Oracle-adatbázisból. A következő javasolt konfigurációk különböző forgatókönyvekhez. Ha fájlalapú adattárba másol adatokat, ajánlott több fájlként írni egy mappába (csak a mappa nevét kell megadni), ebben az esetben a teljesítmény jobb, mint egyetlen fájlba írni.

Forgatókönyv	Javasolt beállítások
Teljes terhelés nagy táblából, fizikai partíciókkal.	Partíciós beállítás: A tábla fizikai partíciói. A végrehajtás során a szolgáltatás automatikusan észleli a fizikai partíciókat, és partíciók alapján másolja az adatokat.
Teljes terhelés nagy táblából fizikai partíciók nélkül, az adatparticionáláshoz pedig egész szám oszlopmal.	Partícióbeállítások: Dinamikus tartomány partíciója. Partícióoszlop: Adja meg az adatok particionálásához használt oszlopot. Ha nincs megadva, a rendszer az elsődleges kulcs oszlopát használja.
Nagy mennyiségű adat betöltése egy egyéni lekérdezés segítségével, fizikai partíciókkal.	Partíciós beállítás: A tábla fizikai partíciói. Lekérdezés: SELECT * FROM <TABLENAME> PARTITION("?AdfTabularPartitionName") WHERE <your_additional_where_clause>. Partíció neve: Adja meg az adatok másolásához használni kívánt partíciónevet. Ha nincs megadva, a szolgáltatás automatikusan észleli az Oracle-adatkészletben megadott tábla fizikai partícióit. A végrehajtás során a szolgáltatás lecseréli a ?AdfTabularPartitionName-t a tényleges partíciónévre, és elküldi az Oracle-nek.
Nagy mennyiségű adat betöltése egyéni lekérdezéssel fizikai partíciók nélkül, az adatparticionáláshoz pedig egész szám oszlopmal.	Partícióbeállítások: Dinamikus tartomány partíciója. Lekérdezés: SELECT * FROM <TABLENAME> WHERE ?AdfRangePartitionColumnName <= ?AdfRangePartitionUpbound AND ?AdfRangePartitionColumnName >= ?AdfRangePartitionLowbound AND <your_additional_where_clause>. Partícióoszlop: Adja meg az adatok particionálásához használt oszlopot. Az egész szám adattípusú oszlop ellen particionálást végezhet. Partíció felső határa és a partíció alsó határa: Adja meg, hogy a partícióoszlopra szeretne-e szűrni, hogy csak az alsó és a felső tartomány közötti adatokat kérje le. A végrehajtás során a szolgáltatás lecseréli az egyes partíciók ?AdfRangePartitionColumnName?AdfRangePartitionUpbound?AdfRangePartitionLowbound tényleges oszlopnevét és értéktartományait, és elküldi az Oracle-nek. Például, ha az "ID" partícióoszlop alsó határa 1, felső határa pedig 80, és a párhuzamos adatlekérés 4 párhuzamos szálon történik, akkor a szolgáltatás 4 partíció alapján kéri le az adatokat. Azonosítójuk [1,20], [21, 40], [41, 60] és [61, 80] között van.

Tipp.

Ha nem particionált táblából másol adatokat, a "Dinamikus tartomány" partícióbeállítással particionálást végezhet egy egész számoszlopon. Ha a forrásadatok nem rendelkeznek ilyen típusú oszlopokkal, használhatja ORA_HASH függvényt a forrás lekérdezésben egy oszlop létrehozásához és partícióoszlopként való használatához.

Példa: lekérdezés fizikai partícióval

"source": {
    "type": "OracleSource",
    "query": "SELECT * FROM <TABLENAME> PARTITION(\"?AdfTabularPartitionName\") WHERE <your_additional_where_clause>",
    "partitionOption": "PhysicalPartitionsOfTable",
    "partitionSettings": {
        "partitionNames": [
            "<partitionA_name>",
            "<partitionB_name>"
        ]
    }
}

Példa: lekérdezés dinamikus tartománypartícióval

"source": {
    "type": "OracleSource",
    "query": "SELECT * FROM <TABLENAME> WHERE ?AdfRangePartitionColumnName <= ?AdfRangePartitionUpbound AND ?AdfRangePartitionColumnName >= ?AdfRangePartitionLowbound AND <your_additional_where_clause>",
    "partitionOption": "DynamicRange",
    "partitionSettings": {
        "partitionColumnName": "<partition_column_name>",
        "partitionUpperBound": "<upper_value_of_partition_column>",
        "partitionLowerBound": "<lower_value_of_partition_column>"
    }
}

Az Oracle adattípus-leképezése

Amikor adatokat másol az Oracle-ből és az Oracle-be, a szolgáltatás az alábbi köztes adattípus-leképezéseket használja. Ha meg szeretné tudni, hogy a másolási tevékenység hogyan térképezi fel a forrássémát és az adattípust a célhelyhez, tekintse meg a séma- és adattípus-leképezéseket.

Oracle-adattípus	Köztes szolgáltatás adattípusa (a 2.0-s verzióhoz)	Köztes szolgáltatás adattípusa (1.0-s verzióhoz)
BFILE	Bájt[]	Bájt[]
lebegőpontos_bináris	Egyedülálló	Egyedülálló
BINARY_DOUBLE (bináris kétrétű szám)	Kétszeres	Kétszeres
BLOB	Bájt[]	Bájt[]
TAKARÍTÓ	Sztring	Sztring
CLOB	Sztring	Sztring
DÁTUM	Dátum/idő	Dátum/idő
FLOAT (P < 16)	Kétszeres	Kétszeres
FLOAT (P >>= 16)	Decimális	Kétszeres
ÉV-HÓNAP INTERVALLUM	Int64	Sztring
NAP ÉS MÁSODPERC KÖZÖTT	Időtartam	Sztring
HOSSZÚ	Sztring	Sztring
Hosszú adat	Bájt[]	Bájt[]
NCHAR	Sztring	Sztring
NCLOB	Sztring	Sztring
SZÁM (p,s)	Int16, Int32, Int64, Single, Double, Decimális	Decimális, karakterlánc (ha p > 28)
SZÁM pontosság és skálázás nélkül	Decimális (256 130)	Kétszeres
NVARCHAR2	Sztring	Sztring
NYERS	Bájt[]	Bájt[]
IDŐBÉLYEG	Dátum/idő	Dátum/idő
IDŐBÉLYEG HELYI IDŐZÓNÁVAL	Dátum/idő	Dátum/idő
IDŐBÉLYEG IDŐZÓNÁVAL	IdőpontEltérés (DateTimeOffset)	Dátum/idő
VARCHAR2	Sztring	Sztring
XMLTYPE	Sztring	Sztring

A NUMBER(p,s) a megfelelő 2.0-s verziójú köztes szolgáltatási adattípusra van leképezve a pontosság (p) és a skálázás (s) függvényében.

Köztes szolgáltatás adattípusa	Állapot
Int16	skála <= 0 ÉS (pontosság - skála) < 5
Int32	skála <= 0 ÉS 5 <= (pontosság - skála) < 10
Int64	skálázás <= 0 ÉS 10 <= (pontosság – skálázás) < 19
Egyedülálló	pontosság < 8 ÉS ((skálázás <= 0 ÉS (pontosság – skálázás) <= 38) VAGY (skálázás > 0 ÉS skálázás <= 44))
Decimális	pontosság >= 16
Kétszeres	Ha a fenti feltételek egyike sem teljesül.

Keresési tevékenység tulajdonságai

A tulajdonságok részleteinek megismeréséhez tekintse meg a keresési tevékenységet.

Az Oracle-összekötő frissítése

Az Oracle-összekötő frissítéséhez az alábbi lépések szükségesek:

1. A Csatolt szolgáltatás szerkesztése lapon válassza a 2.0-s elemet a Verzió területen, és konfigurálja a csatolt szolgáltatást a Csatolt szolgáltatás tulajdonságai 2.0-s verziójára hivatkozva.

   A hitelesítéssel kapcsolatos tulajdonságokhoz, beleértve a felhasználónevet és a jelszót, adja meg az eredeti értékeket a 2.0-s verzió megfelelő mezőiben. Az 1.0-s verzió egyéb kapcsolati tulajdonságai, például a gazdagép, a port és az Oracle-szolgáltatás neve/Oracle SID mostantól a server 2.0-s verzióban található tulajdonság paraméterei.

   Ha például az 1.0-s verziójú társított szolgáltatást konfigurálja az alábbiak szerint:

   

   { 
       "name": "OracleLinkedService", 
       "properties": { 
           "type": "Oracle", 
           "typeProperties": { 
               "connectionString": "host=oraclesample.com;port=1521;servicename=db1" 
           }, 
           "connectVia": { 
               "referenceName": "<name of Integration Runtime>", 
               "type": "IntegrationRuntimeReference" 
           } 
       } 
   }
   

   Az Easy Connect (Plus) elnevezést használó, 2.0-s verziójú társított szolgáltatáskonfiguráció a következő:

   

   { 
       "name": "OracleLinkedService", 
       "properties": { 
           "type": "Oracle", 
           "version": "2.0", 
           "typeProperties": { 
               "server": "oraclesample.com:1521/db1",  
               "username": "<user name>",  
               "password": "<password>",  
               "authenticationType": "<authentication type>" 
           }, 
           "connectVia": { 
               "referenceName": "<name of Integration Runtime>", 
               "type": "IntegrationRuntimeReference" 
           } 
       } 
   } 
   

   A 2.0-s verziójú társított szolgáltatáskonfiguráció az Connector Descriptor használatával a következő:

   

   { 
       "name": "OracleLinkedService", 
       "properties": { 
           "type": "Oracle", 
           "version": "2.0", 
           "typeProperties": { 
               "server": "(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST= oraclesample.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=db1)))",  
               "username": "<user name>",  
               "password": "<password>",  
               "authenticationType": "<authentication type>" 
           }, 
           "connectVia": { 
               "referenceName": "<name of Integration Runtime>", 
               "type": "IntegrationRuntimeReference" 
           } 
       } 
   } 
   

   Tipp.

   Az Azure Key Vault támogatást nyújt a server tulajdonsághoz. A társított szolgáltatás JSON-fájljának szerkesztésével hozzáadhatja az Azure Key Vault referenciát az alábbiak szerint:
   

   Vegye figyelembe:

   • Ha az Oracle szolgáltatásnevet az 1.0-s verzióban használja, a 2.0-s verzióban használhatja az Easy Connect (Plus) elnevezést vagy összekötőleírót kiszolgálóformátumként.

   • Ha az Oracle SID-t az 1.0-s verzióban használja, a 2.0-s verzióban kiszolgálóformátumként az Connector Descriptort kell használnia.

   • Az 1.0-s verzió néhány további kapcsolati tulajdonságához alternatív tulajdonságokat vagy paramétereket biztosítunk a tulajdonságban a server 2.0-s verzióban. Az 1.0-s verzió tulajdonságainak frissítéséhez tekintse meg az alábbi táblázatot.

     1.0-s verzió	2.0-s verzió
     titkosítási módszer	PROTOCOL (paraméter server-ban)
     tnsnamesfile	TNS_ADMIN (a saját üzemeltetésű integrációs modulban támogatott környezeti változó)
     kiszolgálónév	kiszolgáló
     Tömeges betöltés engedélyezése Érték: 1, 0	Engedélyezze a tömeges betöltést Érték: igaz, hamis
     fetchtswtzastimestamp Érték: 1, 0	fetchTswtzAsTimestamp Érték: igaz, hamis
     alternatív kiszolgálók	DESCRIPTION_LIST (a server paraméterben)
     tömbméret	Adatlekérés mérete
     gyorsítótárazott kurzorhatár	utasítás gyorsítótár méret
     kapcsolat-újrapróbálkozás-szám	RETRY_COUNT (paraméter a server-ban)
     inicializáló string	inicializálási karakterlánc
     bejelentkezési időtúllépés	CONNECT_TIMEOUT (paraméter a következőben server: )
     kriptóprotokollverzió	SSL_VERSION (paraméter a server-ben)
     truststore	WALLET_LOCATION (paraméter a server-ben)

     Ha például az 1.0-s verzióban használja alternateservers , beállíthatja a paramétert a DESCRIPTION_LIST kiszolgáló tulajdonságában a 2.0-s verzióban:

     Az 1.0 verziójú társított szolgáltatás a következő használatával alternateservers:

     {
         "name": "OracleV1",
         "properties": {
             "type": "Oracle",
             "typeProperties": {
                 "connectionString": "host=oraclesample.com;port=1521;servicename=db1;alternateservers=(HostName= oraclesample2.com:PortNumber=1521:SID=db2,HostName=255.201.11.24:PortNumber=1522:ServiceName=db3)"
             }
         }
     }
     

     Azonos 2.0-s verziójú társított szolgáltatás az DESCRIPTION_LIST paraméterrel:

     {
         "name": "OracleV2",
         "properties": {
             "type": "Oracle",
             "version": "2.0",
             "typeProperties": {
                 "server": "(DESCRIPTION_LIST=(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=oraclesample.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=db1)))(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=oraclesample2.com)(PORT=1521))(CONNECT_DATA=(SID=db2)))(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=255.201.11.24)(PORT=1522))(CONNECT_DATA=(SERVICE_NAME=db3))))",
                 "username": "<user name>",  
                 "password": "<password>",  
                 "authenticationType": "<authentication type>" 
             }
         }
     }
     

2. Az Oracle társított szolgáltatás 2.0-s verziójának adattípus-leképezése eltér az 1.0-s verziótól. A legújabb adattípus-leképezés megismeréséhez tekintse meg az Oracle adattípus-leképezését.

   A 2.0-s verzió további kapcsolattulajdonságai supportV1DataTypes csökkenthetik az adattípus-módosítások által okozott frissítési nehézségeket. A tulajdonság true beállítása biztosítja, hogy a 2.0-s verzió adattípusa összhangban legyen az 1.0-s verzióval.

Különbségek az Oracle 2.0-s és 1.0-s verziója között

Az Oracle-összekötő 2.0-s verziója új funkciókat kínál, és kompatibilis az 1.0-s verzió legtöbb funkciójával. Az alábbi táblázat a 2.0-s és az 1.0-s verzió közötti funkcióbeli különbségeket mutatja be.

2.0-s verzió	1.0-s verzió
Az Oracle-adattípusoktól a szolgáltatás által belsőleg használt köztes szolgáltatásadattípusokig az alábbi leképezések használhatók. NUMBER(p,s) –> Int16, Int32, Int64, Single, Double, Decimal FLOAT(p)–> Pontossága alapján dupla vagy decimális SZÁM –> Decimális IDŐBÉLYEG IDŐZÓNA SZERINT –> DateTimeOffset INTERVALLUM ÉVRŐL HÓNAPRA –> Int64 INTERVALLUM NAPRÓL MÁSODPERCRE –> Időtartomány	Az Oracle-adattípusoktól a szolgáltatás által belsőleg használt köztes szolgáltatásadattípusokig az alábbi leképezések használhatók. NUMBER(p,s) –> Decimális vagy string a pontossága alapján FLOAT(p)-> Dupla SZÁM –> Dupla IDŐBÉLYEG IDŐZÓNA SZERINT –> DateTime INTERVALLUM ÉVRŐL HÓNAPRA –> Szöveg IDŐKÖZ NAPTÓL MÁSODPERCIG –> Karakterlánc
A convertDecimalToInteger támogatása a másolási forrásban, amikor supportV1DataTypes értéke true.	A convertDecimalToInteger funkció támogatása a forrásmásolásban.
A szkripttevékenység lekérdezési paramétereinek helyőrzőként való használata ? nem támogatott. A névvel ellátott paramétert (például :paramA) vagy a pozícióparamétert (például :1) használhatja csereként.	A szkripttevékenység-lekérdezési paraméterek helyőrzőként való használatának ? támogatása.
TLS 1.3 támogatása.	A TLS 1.3 nem támogatott.
Az Oracle SSO-tárcával együtt használt kétirányú TLS/SSL támogatott. További információkért tekintse meg ezt a cikket	Az Oracle-tárcával rendelkező kétirányú TLS/SSL nem támogatott.