MÁSOLÁS (Transact-SQL)

A következőkre vonatkozik:Azure Synapse Analytics

Tip

Microsoft Fabric Data Warehouse egy nagyvállalati szintű relációs raktár egy Data Lake-alaprendszeren, jövőre kész architektúrával, beépített AI-vel és új funkciókkal. Ha még nem ismerkedik az adattárházakkal, kezdje a Fabric Data Warehouse-szal. A meglévő dedikált SQL-készlet számítási feladatai frissíthetők Fabric az adatelemzés, a valós idejű elemzés és a jelentéskészítés új képességeinek eléréséhez.

• A Fabric ingyenes próbaverzió indítása.
• Fabric Adattárház Migrációs Segédje.

Ez a cikk azt ismerteti, hogyan használhatja a COPY utasítást Azure Synapse Analytics adatok külső tárfiókokból való betöltéséhez. Ez az COPY utasítás a legnagyobb rugalmasságot nyújtja a nagy áteresztőképességű adatfelvételhez az Azure Synapse Analytics-be.

Note

A Microsoft Fabric-beli Warehouse-ról lásd: COPY INTO.

A következő képességek felhasználása COPY :

• Használjon alacsonyabb jogosultságú felhasználókat az adatok betöltéséhez anélkül, hogy szigorú CONTROL-engedélyekre van szüksége az adattárházban.
• Egyetlen T-SQL-utasítás végrehajtása anélkül, hogy más adatbázis-objektumokat kellene létrehoznia.
• Megfelelően elemezze és töltse be azokat a CSV-fájlokat, amelyek elválasztó elemei (sztring, mező, sor) sztringel tagolt oszlopokban vannak feloldva.
• Adjon meg egy finomabb engedélymodellt anélkül, hogy tárfiókkulcsokat ad meg közös hozzáférésű jogosultságkódok (SAS) használatával.
• Használj egy másik tárolófiókot a ERRORFILE helyszínhez (REJECTED_ROW_LOCATION).
• Szabja testre az egyes céloszlopok alapértelmezett értékeit, és adja meg a forrásadatmezőket, hogy betöltődjenek adott céloszlopokba.
• Határozz meg egyedi sorterminátort, mező terminátort és mezőidézetet CSV fájlokhoz.
• CSV-fájlok SQL Server Dátumformátumok használata.
• Adjon meg helyettesítő karaktereket és több fájlt a tárolási hely elérési útján.
• Az automatikus sémafelderítés leegyszerűsíti a forrásadatok céltáblákba való definiálásának és leképezésének folyamatát.
• Az automatikus táblalétrehozási folyamat automatikusan létrehozza a táblákat, és az automatikus sémafelderítés mellett működik.
• Összetett adattípusokat tölthet be közvetlenül a Parquet-fájlokból, például a térképekből és a listákból sztringoszlopokba anélkül, hogy más eszközökkel előfeldolgoznák az adatokat.

Note

Ha összetett adattípusokat szeretne betölteni a Parquet-fájlokból, kapcsolja be az automatikus táblalétrehozás funkciót a használatával AUTO_CREATE_TABLE.

Az utasítást használó COPY átfogó példákért és rövid útmutatókért lásd:

• rövid útmutató: Adatok tömeges betöltése a COPY utasítással
• rövid útmutató: Példák a COPY utasítás és a támogatott hitelesítési módszerek
• rövid útmutató: A COPY utasítás létrehozása a Synapse Studio gazdag felhasználói felületi

Note

Microsoft Entra ID korábban Azure Active Directory (Azure AD) néven ismert.

Syntax

COPY INTO [ schema. ] table_name
[ (Column_list) ]
FROM '<external_location>' [ , ...n ]
WITH
 (
 [ FILE_TYPE = { 'CSV' | 'PARQUET' | 'ORC' } ]
 [ , FILE_FORMAT = EXTERNAL FILE FORMAT OBJECT ]
 [ , CREDENTIAL = (AZURE CREDENTIAL) ]
 [ , ERRORFILE = ' [ http(s)://storageaccount/container ] /errorfile_directory [ / ] ] '
 [ , ERRORFILE_CREDENTIAL = (AZURE CREDENTIAL) ]
 [ , MAXERRORS = max_errors ]
 [ , COMPRESSION = { 'Gzip' | 'DefaultCodec' | 'Snappy' } ]
 [ , FIELDQUOTE = 'string_delimiter' ]
 [ , FIELDTERMINATOR =  'field_terminator' ]
 [ , ROWTERMINATOR = 'row_terminator' ]
 [ , FIRSTROW = first_row ]
 [ , DATEFORMAT = 'date_format' ]
 [ , ENCODING = { 'UTF8' | 'UTF16' } ]
 [ , IDENTITY_INSERT = { 'ON' | 'OFF' } ]
 [ , AUTO_CREATE_TABLE = { 'ON' | 'OFF' } ]
)

Arguments

schema_name

Nem kötelező, ha a műveletet végrehajtó felhasználó alapértelmezett sémája a megadott tábla sémája. Ha nem ad meg sémát, és a műveletet végrehajtó COPY felhasználó alapértelmezett sémája eltér a megadott tábla sémájától, a COPY művelet megszakad, és hibaüzenet jelenik meg.

table_name

Annak a táblának a neve, amelybe az adatokat be szeretné másolni. A céltábla lehet ideiglenes vagy állandó tábla, és már léteznie kell az adatbázisban. Az automatikus sémaészlelési mód esetén ne adjon meg oszloplistát.

(column_list)

Egy vagy több oszlop választható listája, amellyel a forrásadatmezőket az adatok betöltésére szolgáló táblázatoszlopokra képezheti le.

Ne adjon meg column_listAUTO_CREATE_TABLE = 'ON'.

column_list zárójelek közé kell tenni, és vesszővel kell elválasztani. Az oszloplista formátuma a következő:

[(Column_name [alapértelmezett Default_value] [Field_number] [,... n])]

• Column_name – a céltábla oszlopának neve.
• Default_value – az alapértelmezett érték, amely a bemeneti fájl bármely NULL értékét lecseréli. Az alapértelmezett érték az összes fájlformátumra érvényes. A COPY megkísérli betölteni a NULL értéket a bemeneti fájlból, ha egy oszlop ki van hagyva az oszloplistából, vagy ha üres bemeneti fájlmező van. Az alapértelmezett érték megelőzi az "alapértelmezett" kulcsszót
• Field_number – a céloszlopra leképezett bemeneti fájl mezőszáma.
• A mezőindexelés 1-nél kezdődik.

Ha nem ad meg oszloplistát, COPY a forrás és a cél sorrend alapján leképezi az oszlopokat: Az 1. bemeneti mező az 1. céloszlopra, a 2. mező a 2. oszlopra és így tovább.

Külső helyek

Az adatokat tartalmazó fájlok előkészítési helye. Jelenleg Azure Data Lake Storage (ADLS) Gen2 és Azure Blob Storage támogatottak:

• Blob Storage külső helyének: https://<account\>.blob.core.windows.net/<container\>/<path\>
• 2. generációs ADLS külső helyének: https://<account\>.dfs.core.windows.net/<container\>/<path\>

Note

A .blob végpont az ADLS Gen2-hez is elérhető, és jelenleg a legjobb teljesítményt nyújtja. Használja a .blob végpontot, ha .dfs nincs szükség a hitelesítési módszerre.

• Fiók – A tárfiók neve

• Tároló – A blobtároló neve

• Elérési út – az adatok mappája vagy fájl elérési útja. A hely a tárolóból indul ki. Ha megad egy mappát, COPY lekéri az összes fájlt a mappából és annak almappáiból. COPY figyelmen kívül hagyja a rejtett mappákat, és nem ad vissza aláhúzással (_) vagy ponttal (.) kezdődő fájlokat, kivéve, ha az elérési út kifejezetten meg van adva. Ez a viselkedés akkor is ugyanaz, ha helyettesítő karaktert tartalmazó elérési utat ad meg.

Helyettesítő karaktereket is felvehet az elérési útra, ahol:

• A helyettesítő karakterek elérési útjának egyezése megkülönbözteti a kis- és nagybetűk nevét
• A fordított perjel karakterrel () elkerülheti a helyettesítő karaktereket\
• A helyettesítő karakterek kiterjesztése rekurzív módon történik. Az alábbi példában például az összes CSV-fájl Customer1 (beleértve az Customer1alkönyvtárakat is) betöltődik: Account/Container/Customer1/*.csv

Note

A legjobb teljesítmény érdekében ne adjon meg olyan helyettesítő karaktereket, amelyek nagyobb számú fájlon bontanak ki. Ha lehetséges, helyettesítő karakterek megadása helyett listázz több fájlhelyet.

Több fájlhelyet csak ugyanabból a tárfiókból és tárolóból adhat meg egy vesszővel tagolt listában, például:

• https://<account>.blob.core.windows.net/<container\>/<path\>, https://<account\>.blob.core.windows.net/<container\>/<path\>

FILE_TYPE = { 'CSV' | "PARQUET" | "ORC" }

FILE_TYPE A külső adatok formátumát adja meg.

• CSV: Az RFC 4180 szabványnak megfelelő vesszővel tagolt értékfájlt ad meg.
• PARQUET: Parquet formátumot ad meg.
• ORC: Optimalizált soroszlopos (ORC) formátumot ad meg.

Note

A PolyBase "Tagolt szöveg" fájltípusát a CSV fájlformátum váltja fel. Az alapértelmezett vesszőelválasztót a FIELDTERMINATOR paraméteren keresztül konfigurálhatja.

FILE_FORMAT = external_file_format_name

FILE_FORMAT csak Parquet- és ORC-fájlokra vonatkozik. Megadja annak a külső fájlformátum objektumnak a nevét, amely a külső adatok fájltípusát és tömörítési módját tárolja. Külső fájlformátum létrehozásához használja CREATE EXTERNAL FILE FORMAT.

HITELESÍTŐ ADATOK (IDENTITY = '', SECRET = '')

CREDENTIAL Megadja a külső tárfiók eléréséhez szükséges hitelesítési mechanizmust. A hitelesítési módszerek a következők:

	CSV	Parquet	ORC
Azure Blob-tároló	SAS/MSI/SZOLGÁLTATÁSNÉV/KULCS/Entra	SAS/KEY	SAS/KEY
Azure Data Lake Gen2	SAS/MSI/SZOLGÁLTATÁSNÉV/KULCS/Entra	SAS ( blob 1 )/MSI (dfs 2 )/SERVICE PRINCIPAL/KEY/Entra	SAS ( blob 1 )/MSI (dfs 2 )/SERVICE PRINCIPAL/KEY/Entra

¹ A külső hely elérési útjának blob végpontja (.blob.core.windows.net) szükséges ehhez a hitelesítési módszerhez.

² A külső hely elérési útjának dfs végpontja (.dfs.core.windows.net) szükséges ehhez a hitelesítési módszerhez.

Note

• Ha Microsoft Entra ID vagy nyilvános tárfiók használatával hitelesít, nem kell megadnia CREDENTIAL.
• Ha a tárfiók virtuális hálózathoz van társítva, felügyelt identitással kell hitelesítenie magát.

• Hitelesítés közös hozzáférésű jogosultságkódokkal (SAS)

  • IDENTITY: Állandó a következő értékkel: Shared Access Signature
  • SECRET: A közös hozzáférésű jogosultságkód delegált hozzáférést biztosít a tárfiók erőforrásaihoz.

• Minimálisan szükséges engedélyek: READ és LIST

• Hitelesítés szolgáltatásnevek

  • IDENTITY: <ClientID>@<OAuth_2.0_Token_EndPoint>
  • SECRET: Microsoft Entra application service principal key

• Minimális RBAC-szerepkörök szükségesek: Storage-blobadatok közreműködője, Storage-blobadatok közreműködője, Storage-blobadatok tulajdonosa vagy Storage-blobadat-olvasó

• Hitelesítés a Storage-fiók kulccsal

  • IDENTITY: Állandó a következő értékkel: Storage Account Key
  • SECRET: Tárfiók kulcsa

• Hitelesítés felügyelt identitás (VNet-szolgáltatásvégpontok)

  • IDENTITY: Állandó a következő értékkel: Managed Identity

• Minimális RBAC-szerepkörök szükségesek: Storage-blobadatok közreműködője vagy Storage-blobadatok tulajdonosa a Microsoft Entra által regisztrált logikai kiszolgálóhoz az Azure. A Synapse-munkaterülethez nem társított dedikált SQL-készlet (korábbi nevén SQL DW) használatakor ez az RBAC-szerepkör nem szükséges, de a felügyelt identitáshoz Access Control listára (ACL) vonatkozó engedélyek szükségesek a célobjektumokon a forrásfájlok olvasási hozzáférésének engedélyezéséhez.

• Hitelesítés Microsoft Entra-felhasználóval

  • A HITELESÍTŐ ADATOK megadása nem kötelező

• Minimális RBAC-szerepkörök szükségesek: Storage-blobadatok közreműködője vagy Storage-blobadatok tulajdonosa a Microsoft Entra-felhasználó számára

ERRORFILE = Könyvtár helye

ERRORFILE csak a CSV-re vonatkozik. Megadja az utasítás azon könyvtárát COPY , amelyben az elutasított sorok és a megfelelő hibafájl meg van írva. Megadhatja a tárfiók teljes elérési útját, vagy a tárolóhoz viszonyított elérési utat. Ha a megadott elérési út nem létezik, a raktár létrehoz egyet. A rendszer létrehoz egy gyermekkönyvtárat a névvel _rejectedrows. A _ karakter biztosítja, hogy a könyvtár más adatfeldolgozáshoz is meg legyen szökve, kivéve, ha a helyparaméter kifejezetten el van nevezve.

Note

Ha relatív elérési utat ERRORFILEad át, az a external_location megadott tárolóútvonalhoz képest legyen.

Ebben a könyvtárban a raktár létrehoz egy mappát a betöltési idő alapján a formátumban YearMonthDay -HourMinuteSecond (például 20180330-173205). Ebben a mappában a folyamat két fájltípust ír: az okfájlt (hiba) és az adatfájlt (sorfájlt). Minden fájl előküldi a queryID, distributionIDés egy fájl GUID azonosítót. Mivel az adatok és az ok külön fájlokban találhatók, a megfelelő fájloknak egyező előtagjuk van.

Ha ERRORFILE a tárfiók teljes elérési útja definiálva van, COPY a tárhoz való csatlakozást használja ERRORFILE_CREDENTIAL . Ellenkező esetben a megadott CREDENTIALértéket használja. Ha ugyanazt a hitelesítő adatot használja a forrásadatokhoz, és ERRORFILEa vonatkozó korlátozások ERRORFILE_CREDENTIAL is érvényesek.

ERRORFILE_CREDENTIAL = (IDENTITY = '', SECRET = '')

ERRORFILE_CREDENTIAL csak CSV-fájlokra vonatkozik. A támogatott adatforrás- és hitelesítési módszerek a következők:

• Azure Blob Storage: SAS, szolgáltatásnév vagy Microsoft Entra

• Azure Data Lake Gen2: SAS, MSI, szolgáltatásnév vagy Microsoft Entra

• Hitelesítés közös hozzáférésű jogosultságkódokkal (SAS)

  • IDENTITY: Állandó a következő értékkel: Shared Access Signature
  • SECRET: A közös hozzáférésű jogosultságkód delegált hozzáférést biztosít a tárfiók erőforrásaihoz.

• Minimálisan szükséges engedélyek: OLVASÁS, LISTA, ÍRÁS, LÉTREHOZÁS, TÖRLÉS

• Hitelesítés szolgáltatásnevek

  • IDENTITY: <ClientID>@<OAuth_2.0_Token_EndPoint>
  • SECRET: Microsoft Entra application service principal key

• Minimális RBAC-szerepkörök szükségesek: Storage-blobadatok közreműködője vagy Storage-blobadatok tulajdonosa

Note

Az OAuth 2.0 tokenvégpont használata V1

• Hitelesítés felügyelt identitás (VNet-szolgáltatásvégpontok)

  • IDENTITY: Állandó a következő értékkel: Managed Identity

• Minimális RBAC-szerepkörök szükségesek: Storage-blobadatok közreműködője vagy Storage-blobadatok tulajdonosa a Microsoft Entra regisztrált SQL Database-kiszolgálóhoz

• Hitelesítés Microsoft Entra-felhasználóval

  • CREDENTIAL nincs szükség

• Minimális RBAC-szerepkörök szükségesek: Storage-blobadatok közreműködője vagy Storage-blobadatok tulajdonosa a Microsoft Entra-felhasználó számára

A tárfiókkulcs ERRORFILE_CREDENTIAL használata nem támogatott.

Note

Ha ugyanazt a tárfiókot használja a hibafájlhoz, és megadja a ERRORFILE tároló gyökeréhez viszonyított elérési utat, akkor nem kell megadnia a ERROR_CREDENTIAL.

MAXERRORS = max_errors

MAXERRORS A MÁSOLÁS művelet meghiúsulása előtt a betöltés során engedélyezett elvetési sorok maximális számát adja meg. A MÁSOLÁS művelet nem importálható sorokat figyelmen kívül hagyja, és egyetlen hibának számít. Ha nem ad meg értéket a hibák maximális számához, az alapértelmezett érték a következő 0.

MAXERRORS nem használható a AUTO_CREATE_TABLE.

Ha FILE_TYPE igen, akkor az PARQUETadattípus-konverziós hibák (például a Parquet binárisból SQL egész számmá) által okozott kivételek továbbra is COPY INTO meghiúsulnak, figyelmen kívül hagyva.MAXERRORS

COMPRESSION = { 'DefaultCodec ' | "Snappy" | "GZIP" | 'NONE'}

COMPRESSION nem kötelező, és megadja a külső adatok adattömörítési módszerét.

• A CSV támogatja a GZIP-t.
• A Parquet támogatja a GZIP-t és a Snappy-t.
• Az ORC támogatja a DefaultCodec és a Snappy protokollt.
• A Zlib az ORC alapértelmezett tömörítése.

A COPY parancs automatikusan észleli a tömörítés típusát a fájlkiterjesztés alapján, ha nem adja meg ezt a paramétert:

• .gz - GZIP
• .snappy - Rámenős
• .deflate - DefaultCodec (csak parquet és ORC)

A COPY parancs megköveteli, hogy a gzip-fájlok ne tartalmazzanak semmilyen záró szemetet a normál működéshez. A gzip formátum szigorúan megköveteli, hogy a fájlok érvényes tagokból legyenek összeállítva anélkül, hogy további információk kellenek az előttük, közöttük vagy utánuk. Az ettől a formátumtól való bármely eltérés, például a záró, nem gzip adatok jelenléte a COPY parancs hibáját eredményezi. A COPY sikeres futtatásának biztosításához győződjön meg arról, hogy a gzip-fájlok végén nincs záró szemét.

FIELDQUOTE = 'field_quote'

A FIELDQUOTE a CSV-ra vonatkozik, és egyetlen karaktert határoz meg, amelyet a CSV-fájlban idézőjelként (sztringelválasztóként) használnak. Ha nem adja meg ezt az értéket, a rendszer az RFC 4180 szabványban meghatározott idézőjelként (") használja. Hexadecimális jelölés is támogatott .FIELDQUOTE A kiterjesztett ASCII- és többbájtos karakterek nem támogatottak az UTF-8 esetében FIELDQUOTE.

Note

A MEZŐKVÓTA karakterek sztringoszlopokban vannak megszűrve, ahol kettős MEZŐKvótát (elválasztó) jelenik meg.

FIELDTERMINATOR = 'field_terminator'

FIELDTERMINATOR csak a CSV-re vonatkozik. A CSV-fájlban használt mező-terminátort adja meg. A mező terminátorát hexadecimális jelöléssel adhatja meg. A mező terminátora lehet többkarakteres. Az alapértelmezett mezőkifejezés a (,). A kiterjesztett ASCII- és többbájtos karakterek nem támogatottak az UTF-8 esetében FIELDTERMINATOR.

ROWTERMINATOR = 'row_terminator'

ROWTERMINATOR csak a CSV-re vonatkozik. A CSV-fájlban használt sor terminátorát adja meg. A sor terminátorát hexadecimális jelöléssel adhatja meg. A sor terminátora többkarakteres is lehet. Alapértelmezés szerint a sor terminátora \r\n.

A COPY parancs előtagja a \r karakter, amikor \n (új vonal) megadásával \r\n. Ha csak a \n karaktert szeretné megadni, használja a hexadecimális jelölést (0x0A). Ha hexadecimális többkarakteres sor terminátorokat ad meg, ne adja meg 0x az egyes karaktereket.

A kiterjesztett ASCII- és többbájtos karakterek nem támogatottak az UTF-8 esetében ROWTERMINATOR.

FIRSTROW = First_row_int

FIRSTROW a CSV-ra vonatkozik, és megadja az elsőként beolvasott sorszámot a COPY parancs összes fájljában. Az értékek az alapértelmezett értéktől 1kezdődnek. Ha az értéket úgy állítja be, hogy 2minden fájl (fejlécsor) első sora ki lesz hagyva az adatok betöltésekor. A sorok kihagyása a sorkifejezők meglétén alapul.

DATEFORMAT = { 'mdy' | 'dmy' | "ymd" | "ydm" | 'myd' | 'dym' }

A DATEFORMAT csak a CSV-ra vonatkozik, és az SQL Server dátumformátumaihoz való dátumleképezés dátumformátumát adja meg. Az összes Transact-SQL dátum- és időadattípus és -függvény áttekintése: Dátum- és időadattípusok és függvények (Transact-SQL). A DATEFORMAT a COPY parancson belül elsőbbséget élvez munkamenet szintjén konfigurált DATEFORMAT paranccsal szemben.

ENCODING = "UTF8" | "UTF16"

ENCODING csak a CSV-re vonatkozik. Az alapértelmezett érték az UTF8. Megadja a COPY parancs által betöltött fájlok adatkódolási szabványát.

IDENTITY_INSERT = 'ON' | "KI"

IDENTITY_INSERT megadja, hogy az importált adatfájl identitásértékét vagy értékeit kell-e használni az identitásoszlophoz. Ha IDENTITY_INSERT ez ( OFF alapértelmezett), a rendszer ellenőrzi az oszlop identitásértékét, de nem importálja. Figyelje meg az alábbi viselkedést a COPY paranccsal:

• Ha IDENTITY_INSERT ki van kapcsolva, és a tábla identitásoszlopot tartalmaz
  • Olyan oszloplistát kell megadnia, amely nem képez le bemeneti mezőt az identitásoszlophoz.
• Ha IDENTITY_INSERT be van kapcsolva, és a tábla identitásoszlopot tartalmaz
  • Ha egy oszloplistát ad át, annak le kell képeznie egy bemeneti mezőt az identitásoszlophoz.
• Az oszloplista IDENTITÁS oszlopa nem támogatja az alapértelmezett értéket.
• Egyszerre csak egy táblát állíthat be IDENTITY_INSERT .

Az Azure Synapse Analytics automatikusan egyedi értékeket rendel hozzá a tábla létrehozása során megadott mag- és növekményértékek alapján.

AUTO_CREATE_TABLE = { 'ON' | "KI" }

AUTO_CREATE_TABLE megadja, hogy a tábla automatikusan létrehozható-e az automatikus sémafelderítéssel együtt. AUTO_CREATE_TABLE csak parquet-fájlokhoz érhető el Azure Synapse Analytics.

• BE: Automatikus táblalétrehozás engedélyezése. A COPY INTO folyamat automatikusan létrehoz egy új táblát a betöltendő fájl szerkezetének felderítésével. A parquet-fájlok automatikus sémafelderítésének előnyeinek kihasználásához használhatja az előre meglevő táblákkal is.
• KI: Az automatikus táblalétrehozás nincs engedélyezve. Default.

Note

Az automatikus táblalétrehozás az automatikus sémafelderítés mellett működik. Az automatikus táblalétrehozás alapértelmezés szerint nincs engedélyezve.

Permissions

A COPY parancsot futtató felhasználónak a következő engedélyekkel kell rendelkeznie:

• ADATBÁZIS TÖMEGES MŰVELETEINEK FELÜGYELETE
• INSERT

A TÖMEGES MŰVELETEK BESZÚRÁSA és FELÜGYELETE engedélyre van szükség. Az Azure Synapse Analyticsben az INSERT és a ADMIN ADATBÁZIS TÖMEGES MŰVELETEK engedélyére van szükség.

Emellett ha a COPY parancsot végrehajtó felhasználó új táblát is létre kíván hozni, és adatokat szeretne betölteni a táblába, akkor a CREATE TABLE és az ALTER ON SCHEMA engedélyre van szükségük.

Ha például engedélyezni szeretné, hogy mike@contoso.com a COPY használatával hozzon létre egy új táblát a HR sémában, és beszúrja az adatokat egy Parquet-fájlból, használja az alábbi Transact-SQL mintát:

GRANT ADMINISTER DATABASE BULK OPERATIONS to [mike@contoso.com];
GRANT INSERT to [mike@contoso.com];

GRANT CREATE TABLE to [mike@contoso.com];
GRANT ALTER on SCHEMA::HR to [mike@contoso.com];

Remarks

Az COPY utasítás csak UTF-8 és UTF-16 érvényes karaktereket fogad el soradatokhoz és parancsparaméterekhez. Az COPY utasítás helytelenül értelmezhet olyan forrásfájlokat vagy paramétereket (például ROWTERMINATOR vagy FIELDTERMINATOR), amelyek érvénytelen karaktereket használnak, és váratlan eredményeket, például adatsérülést vagy egyéb hibákat okoznak. Győződj meg róla, hogy a forrásfájljaid és paramétereid megfelelnek az UTF-8 vagy UTF-16 szabványoknak, mielőtt behívod az COPY utasítást.

A MAXDOP lekérdezési tipp nem támogatott COPY INTO.

A megbízható végrehajtás érdekében ne módosítsa a forrásfájlokat és mappákat a COPY INTO művelet során.

• A hivatkozott fájlok vagy mappák módosítása, törlése vagy cseréje a parancs futtatása közben a művelet sikertelenségéhez vagy inkonzisztens adatbetöltéshez vezethet.
• A végrehajtás COPY INTOelőtt ellenőrizze, hogy az összes forrásadat stabil-e, és nem változik-e a folyamat során.

Ha a forrásadatok pontossága nagyobb, mint a céloszlop definíciója, akkor az érték csonkolt, nem kerekítve, numerikus, dátum- és időtípusok esetén.

Examples

A. Betöltés nyilvános tárfiókból

Az alábbi példa a parancs legegyszerűbb formáját mutatja be, amely betölti az COPY adatokat egy nyilvános tárfiókból. Ebben a példában az COPY utasítás alapértelmezett értéke megegyezik a sorelem CSV-fájljának formátumával.

COPY INTO dbo.[lineitem]
FROM 'https://unsecureaccount.blob.core.windows.net/customerdatasets/folder1/lineitem.csv'
WITH (FIELDTERMINATOR = '|')

A COPY parancs alapértelmezett értékei a következők:

• DATEFORMAT = Session DATEFORMAT

• MAXERRORS = 0

• COMPRESSION az alapértelmezett tömörítés nélküli

• FIELDQUOTE = '"'

• FIELDTERMINATOR = ','

• ROWTERMINATOR = '\n'

Important

COPY úgy \n kezeli, mint \r\n belsőleg. További információkért lásd a szakaszt ROWTERMINATOR .

• FIRSTROW = 1

• ENCODING = 'UTF8'

• FILE_TYPE = 'CSV'

• IDENTITY_INSERT = "KI"

B. Hitelesítés betöltése megosztási jogosultságkód (SAS) használatával

Az alábbi példa betölti azokat a fájlokat, amelyek sorkimenetként használják a sor hírcsatornát, például UNIX-kimenetként. Ez a példa saskulcsot is használ az Azure Blob Storage-ban való hitelesítéshez.

COPY INTO test_1
FROM 'https://myaccount.blob.core.windows.net/myblobcontainer/folder1/'
WITH (
    FILE_TYPE = 'CSV',
    CREDENTIAL=(IDENTITY= 'Shared Access Signature', SECRET='<Your_SAS_Token>'),
    --CREDENTIAL should look something like this:
    --CREDENTIAL=(IDENTITY= 'Shared Access Signature', SECRET='?sv=2018-03-28&ss=bfqt&srt=sco&sp=rl&st=2016-10-17T20%3A14%3A55Z&se=2021-10-18T20%3A19%3A00Z&sig=IEoOdmeYnE9%2FKiJDSHFSYsz4AkNa%2F%2BTx61FuQ%2FfKHefqoBE%3D'),
    FIELDQUOTE = '"',
    FIELDTERMINATOR=';',
    ROWTERMINATOR='0X0A',
    ENCODING = 'UTF8',
    DATEFORMAT = 'ymd',
    MAXERRORS = 10,
    ERRORFILE = '/errorsfolder',--path starting from the storage container
    IDENTITY_INSERT = 'ON'
)

C. Betöltés olyan oszloplistával, amely alapértelmezett értékekkel hitelesíti a tárfiókkulcsot

Ez a példa betölti az alapértelmezett értékeket tartalmazó oszloplistát meghatározó fájlokat.

--Note when specifying the column list, input field numbers start from 1
COPY INTO test_1 (Col_one default 'myStringDefault' 1, Col_two default 1 3)
FROM 'https://myaccount.blob.core.windows.net/myblobcontainer/folder1/'
WITH (
    FILE_TYPE = 'CSV',
    CREDENTIAL=(IDENTITY= 'Storage Account Key', SECRET='<Your_Account_Key>'),
    FIELDQUOTE = '"',
    FIELDTERMINATOR=',',
    ROWTERMINATOR='0x0A',
    ENCODING = 'UTF8',
    FIRSTROW = 2
)

D. Parquet vagy ORC betöltése meglévő fájlformátum-objektum használatával

Ez a példa helyettesítő karakterrel tölti be az összes Parquet-fájlt egy mappába.

COPY INTO test_parquet
FROM 'https://myaccount.blob.core.windows.net/myblobcontainer/folder1/*.parquet'
WITH (
    FILE_FORMAT = myFileFormat,
    CREDENTIAL=(IDENTITY= 'Shared Access Signature', SECRET='<Your_SAS_Token>')
)

E. Helyettesítő kártyák és több fájl betöltése

COPY INTO t1
FROM
'https://myaccount.blob.core.windows.net/myblobcontainer/folder0/*.txt',
    'https://myaccount.blob.core.windows.net/myblobcontainer/folder1'
WITH (
    FILE_TYPE = 'CSV',
    CREDENTIAL=(IDENTITY= '<client_id>@<OAuth_2.0_Token_EndPoint>',SECRET='<key>'),
    FIELDTERMINATOR = '|'
)

F. Betöltés MSI-hitelesítő adatokkal

COPY INTO dbo.myCOPYDemoTable
FROM 'https://myaccount.blob.core.windows.net/myblobcontainer/folder0/*.txt'
WITH (
    FILE_TYPE = 'CSV',
    CREDENTIAL = (IDENTITY = 'Managed Identity'),
    FIELDQUOTE = '"',
    FIELDTERMINATOR=','
)

G. Betöltés automatikus sémaészlelés használatával

COPY INTO [myCOPYDemoTable]
FROM 'https://myaccount.blob.core.windows.net/customerdatasets/folder1/lineitem.parquet'
WITH (
    FILE_TYPE = 'Parquet',
    CREDENTIAL = ( IDENTITY = 'Shared Access Signature',  SECRET='<key>'),
    AUTO_CREATE_TABLE = 'ON'
)

GYIK

Hogyan viszonyul a COPY parancs teljesítménye a PolyBase-hez?

A COPY parancs teljesítménye a számítási feladattól függően jobb lehet.

• A raktár nem tudja automatikusan felosztani a tömörített fájlokat. A legjobb betöltési teljesítmény érdekében fontolja meg a bemenet több fájlra való felosztását tömörített CSV-k betöltésekor.

• A raktár automatikusan feloszthatja a nagy tömörítetlen CSV-fájlokat a párhuzamos betöltéshez, így általában nem kell manuálisan felosztania a tömörítetlen CSV-fájlokat. Bizonyos esetekben, amikor az adattulajdonságok miatt az automatikus fájlfelosztás nem lehetséges, a nagy CSV-k manuális felosztása továbbra is előnyös lehet a teljesítmény szempontjából.

Mi a tömörített CSV-fájlok betöltésére szolgáló COPY parancs fájlmegosztási útmutatója?

Az alábbi táblázat a használni kívánt fájlok számát ismerteti. Ha eléri az ajánlott fájlszámot, nagyobb fájlok esetén jobb teljesítményt érhet el. A fájlok számát a számítási csomópontok száma és 60 szorzata határozza meg. Például 6000 DWU-n 12 számítási csomópontja van, így 12 * 60 = 720 partícióval rendelkezik. Az egyszerű fájlfelosztási élményért tekintse meg a COPY betöltési sebesség maximalizálását fájlmegosztásokkal.

DWU	Fájlok száma
100	60
200	60
300	60
400	60
500	60
1,000	120
1,500	180
2,000	240
2,500	300
3,000	360
5,000	600
6,000	720
7,500	900
10,000	1200
15,000	1800
30,000	3600

Mi az a fájlmegosztási útmutató a COPY parancs parquet- vagy ORC-fájlok betöltéséhez?

Nem kell felosztania a Parquet- és ORC-fájlokat, mert a COPY parancs automatikusan felosztja a fájlokat. A legjobb teljesítmény érdekében a Azure tárfiók parquet- és ORC-fájljainak 256 MB-nak vagy nagyobbnak kell lenniük.

Vannak korlátozások a fájlok számára vagy méretére?

A fájlok száma és mérete nincs korlátozva. A legjobb teljesítmény érdekében azonban legalább 4 MB méretű fájlokat használjon. Emellett a jobb teljesítmény érdekében korlátozza a forrásfájlok számát legfeljebb 5000 fájlra.

Vannak ismert problémák a COPY utasítással kapcsolatban?

Ha 2020. december 7. előtt létrehozott Azure Synapse munkaterülete van, hasonló hibaüzenet jelenhet meg a felügyelt identitással végzett hitelesítéskor: com.microsoft.sqlserver.jdbc.SQLServerException: Managed Service Identity isn't enabled on this server. Please enable Managed Service Identity and try again.

A probléma megoldásához regisztrálja újra a munkaterület felügyelt identitását:

1. Telepítse az Azure PowerShellt. Lásd: A PowerShell telepítése.
2. A munkaterület felügyelt identitásának regisztrálása a PowerShell használatával:

   Connect-AzAccount
   Select-AzSubscription -SubscriptionId <subscriptionId>
   Set-AzSqlServer -ResourceGroupName your-database-server-resourceGroup -ServerName your-SQL-servername -AssignIdentity
   

Kapcsolódó tartalom

• Betöltési áttekintés az Azure Synapse Analytics