KOPYALA (Transact-SQL)

Şunlar için geçerlidir: Azure Synapse Analytics

Bu makale, Azure Synapse Analytics'te dış depolama hesaplarından yükleme için bu COPY ifadenin nasıl kullanılacağını açıklar. Bu açıklama COPY , Azure Synapse Analytics'e yüksek verimlilikte veri alımı için en fazla esnekliği sağlar.

Note

Microsoft Fabric'teki Ambar için COPY INTOadresini ziyaret edin.

Aşağıdaki özellikler için COPY kullanın:

• Veri ambarı üzerinde katı CONTROL izinlerine gerek kalmadan yüklemek için daha düşük ayrıcalıklı kullanıcılar kullanın
• Başka bir veritabanı nesnesi oluşturmak zorunda kalmadan tek bir T-SQL deyimi yürütme
• sınırlayıcı (dize, alan, satır) dizeyle ayrılmış sütunlar içinde kaçış CSV dosyalarını düzgün ayrıştırma ve yükleme
• Paylaşım Erişim İmzaları (SAS) kullanarak depolama hesabı anahtarlarını göstermeden daha ince bir izin modeli belirtin
• Konum için ERRORFILE farklı bir depolama hesabı kullanın (REJECTED_ROW_LOCATION)
• Her hedef sütun için varsayılan değerleri özelleştirin ve belirli hedef sütunlara yüklenecek kaynak veri alanlarını belirtin
• CSV dosyaları için özel satır sonlandırıcısı, alan sonlandırıcısı ve alan alıntısı belirtme
• CSV dosyaları için SQL Server Tarih biçimlerini kullanma
• Depolama konumu yolunda joker karakterler ve birden çok dosya belirtme
• Otomatik şema bulma, kaynak verileri tanımlama ve hedef tablolara eşleme işlemini basitleştirir
• Otomatik tablo oluşturma işlemi tabloları otomatik olarak oluşturur ve otomatik şema bulma ile birlikte çalışır
• Haritalar ve Listeler gibi Parquet dosyalarından karmaşık veri türlerini, verileri önceden işlemek için diğer araçları kullanmadan doğrudan dize sütunlarına yükleyin

Note

Parquet dosyalarından karmaşık veri türlerini yüklemek için otomatik tablo oluşturma AUTO_CREATE_TABLEkullanılarak açılmalıdır.

COPY deyimini kullanarak kapsamlı örnekler ve hızlı başlangıçlar için aşağıdaki belgeleri ziyaret edin:

• Hızlı Başlangıç: COPY deyimini kullanarak verileri toplu yükleme
• Hızlı Başlangıç: COPY deyimini ve desteklenen kimlik doğrulama yöntemlerini kullanan örnekler
• Hızlı Başlangıç: Zengin Synapse Studio kullanıcı arabirimini kullanarak COPY deyimini oluşturma

Note

Microsoft Entra ID daha önce Azure Active Directory (Azure AD) olarak biliniyordu.

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

İşlemi gerçekleştiren kullanıcının varsayılan şeması belirtilen tablonun şemasıysa isteğe bağlı. Şema belirtilmezse ve COPY işlemini gerçekleştiren kullanıcının varsayılan şeması belirtilen tablonun şemasından farklıysa COPY işlemi iptal edilir ve bir hata iletisi döndürülür.

table_name

Verileri kopyalanacak tablonun adı. Hedef tablo geçici veya kalıcı bir tablo olabilir ve veritabanında zaten mevcut olmalıdır. Otomatik şema algılama modu için sütun listesi sağlamayın.

(column_list)

Kaynak veri alanlarını verileri yüklemek için hedef tablo sütunlarına eşlemek için kullanılan bir veya daha fazla sütunun isteğe bağlı listesi.

zaman AUTO_CREATE_TABLE = 'ON' belirtmeyin.

column_list ayraç içine alınmalı ve virgülle sınırlandırılmalıdır. Sütun listesi aşağıdaki biçimdedir:

[(Column_name [varsayılan Default_value] [Field_number] [,... n])]

• Column_name - Hedef tablodaki sütunun adı.
• Default_value - giriş dosyasındaki herhangi bir NULL değerin yerini alan varsayılan değerdir. Varsayılan değer tüm dosya biçimleri için geçerlidir. COPY, sütun listesinden bir sütun atlandığında veya boş bir giriş dosyası alanı olduğunda giriş dosyasından NULL yüklemeyi dener. Varsayılan değer 'default' anahtar sözcüğünden önce
• Field_number - Hedef sütuna eşlenen giriş dosyası alan numarası.
• Alan dizin oluşturma 1'de başlar.

Sütun listesi belirtilmediğinde COPY sütunları kaynak ve hedef sırasına göre eşler: Giriş alanı 1 hedef sütun 1'e, 2. alan 2. sütuna vb. gider.

Dış konumlar

Verileri içeren dosyaların hazırlandığı yerdir. Şu anda Azure Data Lake Storage (ADLS) 2. Nesil ve Azure Blob Depolama desteklenmektedir:

• Blob Depolama için dış konum :
• ADLS 2. Nesil: için dış konum

Note

Uç .blob nokta ADLS 2. Nesil için de kullanılabilir ve şu anda en iyi performansı verir. Kimlik doğrulama yönteminiz için .blob gerekli olmadığında .dfs uç noktasını kullanın.

• Hesabı - Depolama hesabı adı

• Kapsayıcı - Blob kapsayıcı adı

• Yol - verilerin klasörü veya dosya yolu. Konum kapsayıcıdan başlar. Bir klasör belirtilirse, COPY klasöründeki tüm dosyaları ve tüm alt klasörlerini alır. COPY gizli klasörleri yoksayar ve yolda açıkça belirtilmediği sürece bir alt çizgi (_) veya nokta (.) ile başlayan dosyaları döndürmez. Bu davranış, joker karakter içeren bir yol belirtirken bile aynıdır.

Joker karakterler kartları,

• Joker karakter yol adı eşleştirme büyük/küçük harfe duyarlıdır
• Ters eğik çizgi karakteri (\) kullanılarak joker karakterden kaçılabilir
• Joker karakter genişletmesi özyinelemeli olarak uygulanır. Örneğin, altındaki Customer1 tüm CSV dosyaları (alt dizinleri Customer1dahil) aşağıdaki örnekte yüklenir: Account/Container/Customer1/*.csv

Note

En iyi performans için, daha fazla sayıda dosyaya genişletecek joker karakterler belirtmekten kaçının. Mümkünse joker karakter belirtmek yerine birden çok dosya konumunu listeleyin.

Birden çok dosya konumu yalnızca aynı depolama hesabından ve kapsayıcısından virgülle ayrılmış bir liste aracılığıyla belirtilebilir:

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

FILE_TYPE = { 'CSV' | 'PARKET' | 'ORK' }

FILE_TYPE dış verilerin biçimini belirtir.

• CSV: RFC 4180 standardıyla uyumlu virgülle ayrılmış değerler dosyasını belirtir.
• PARQUET: Parquet biçimini belirtir.
• ORC: İyileştirilmiş Satır Sütunlu (ORC) biçimini belirtir.

Note

PolyBase'deki 'Sınırlandırılmış Metin' dosya türü, varsayılan virgül sınırlayıcının FIELDTERMINATOR parametresi aracılığıyla yapılandırılabildiği 'CSV' dosya biçimiyle değiştirilir.

FILE_FORMAT = external_file_format_name

FILE_FORMAT yalnızca Parquet ve ORC dosyaları için geçerlidir ve dış veriler için dosya türünü ve sıkıştırma yöntemini depolayan dış dosya biçimi nesnesinin adını belirtir. Dış dosya biçimi oluşturmak için CREATE EXTERNAL FILE FORMATkullanın.

CREDENTIAL (IDENTITY = '', SECRET = '')

CREDENTIAL, dış depolama hesabına erişmek için kimlik doğrulama mekanizmasını belirtir. Kimlik doğrulama yöntemleri şunlardır:

	CSV	Parquet	ORC
Azure Blob Depolama	SAS/MSI/HIZMET SORUMLUSU/ANAHTAR/Entra	SAS/KEY	SAS/KEY
Azure Data Lake 2. Nesil	SAS/MSI/HIZMET SORUMLUSU/ANAHTAR/Entra	SAS (blob 1 )/MSI (dfs 2 )/HİzMET SORUMLUSU/ANAHTAR/Entra	SAS (blob 1 )/MSI (dfs 2 )/HİzMET SORUMLUSU/ANAHTAR/Entra

¹ Bu kimlik doğrulama yöntemi için dış konum yolunuzdaki blob uç noktası (.blob.core.windows.net) gereklidir.

² Bu kimlik doğrulama yöntemi için dış konum yolunuzdaki dfs uç noktası (.dfs.core.windows.net) gereklidir.

Note

• Microsoft Entra Id kullanarak veya genel bir depolama hesabında kimlik doğrulaması yaparken, KIMLIK BILGILERININ belirtilmesi gerekmez.
• Depolama hesabınız bir sanal ağ ile ilişkiliyse, yönetilen kimlik kullanarak kimlik doğrulaması yapmanız gerekir.

• Paylaşılan Erişim İmzalarıyla (SAS) Kimlik Doğrulaması

  • KIMLIĞI: 'Paylaşılan Erişim İmzası' değerine sahip bir sabit
  • SECRET:paylaşılan erişim imzası, depolama hesabınızdaki kaynaklara temsilci erişimi sağlar.

• Gereken en düşük izinler: OKUMA ve LİSTE

• Hizmet Sorumlularıyla kimlik doğrulaması

  • <@>ClientID<
  • SECRET: Microsoft Entra uygulama hizmeti asıl anahtarı

• Gereken en düşük RBAC rolleri: Depolama blob verileri katkıda bulunanı, Depolama blob verileri katkıda bulunanı, Depolama blobu veri sahibi veya Depolama blob veri okuyucusu

• Depolama hesabı anahtarıyla kimlik doğrulaması

  • KIMLIĞI: 'Depolama Hesabı Anahtarı' değerine sahip bir sabit

• SECRET: Depolama hesabı anahtarı

• Yönetilen Kimlik (VNet Hizmet Uç Noktaları) ile kimlik doğrulaması

  • KİmLİk: 'Yönetilen Kimlik' değerine sahip sabit

• Gereken en düşük RBAC rolleri: Azure'de Microsoft Entra kayıtlı mantıksal sunucusu için depolama blobu veri katkıda bulunanı veya Depolama blobu veri sahibi. Synapse Çalışma Alanı ile ilişkilendirilmemiş ayrılmış bir SQL havuzu (eski adı SQL DW) kullanılırken bu RBAC rolü gerekli değildir, ancak yönetilen kimlik, kaynak dosyalara okuma erişimini etkinleştirmek için hedef nesnelerde Erişim Denetim Listesi (ACL) izinleri gerektirir

• Microsoft Entra kullanıcısıyla kimlik doğrulaması

  • KIMLIK BILGILERI gerekli değildir

• Gereken en düşük RBAC rolleri: Microsoft Entra kullanıcısı için depolama blob verileri katkıda bulunanı veya Depolama blobu veri sahibi

ERRORFILE = Dizin Konumu

ERRORFILE yalnızca CSV için geçerlidir. COPY deyiminde reddedilen satırların ve karşılık gelen hata dosyasının yazılması gereken dizini belirtir. Depolama hesabından tam yol belirtilebilir veya kapsayıcıya göre yol belirtilebilir. Belirtilen yol yoksa, sizin adınıza bir yol oluşturulur. adlı _rejectedrowsbir alt dizin oluşturulur. karakteri, _ konum parametresinde açıkça adlandırılmadığı sürece dizinin diğer veri işleme için kaçış olmasını sağlar.

Note

ERRORFILEgöreli yol geçirildiğinde, yol external_locationiçinde belirtilen kapsayıcı yoluna göredir.

Bu dizinde, YearMonthDay -HourMinuteSecond (Örn. 20180330-173205) biçiminde yük gönderme zamanına göre oluşturulan bir klasör vardır. Bu klasörde, her biri queryID, distributionID ve bir dosya guid'i ile önceden uygulanan neden (Hata) dosyası ve veri (Satır) dosyası olmak üzere iki tür dosya yazılır. Veriler ve nedeni ayrı dosyalarda olduğundan, ilgili dosyaların eşleşen bir ön eki vardır.

ERRORFILE tanımlı depolama hesabının tam yoluna sahipse, bu depolamaya bağlanmak için ERRORFILE_CREDENTIAL kullanılır. Aksi takdirde, CREDENTIAL için belirtilen değer kullanılır. ERRORFILE için kaynak veriler için kullanılan aynı kimlik bilgisi kullanıldığında, ERRORFILE_CREDENTIAL için geçerli olan kısıtlamalar da geçerlidir

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

ERRORFILE_CREDENTIAL yalnızca CSV dosyaları için geçerlidir. Desteklenen veri kaynağı ve kimlik doğrulama yöntemleri şunlardır:

• Azure Blob Depolama - SAS/SERVICE PRINCIPAL/Entra

• Azure Data Lake 2. Nesil - SAS/MSI/SERVICE PRINCIPAL/Entra

• Paylaşılan Erişim İmzalarıyla (SAS) Kimlik Doğrulaması

  • KIMLIĞI: 'Paylaşılan Erişim İmzası' değerine sahip bir sabit
  • SECRET:paylaşılan erişim imzası, depolama hesabınızdaki kaynaklara temsilci erişimi sağlar.

• Gereken en düşük izinler: READ, LIST, WRITE, CREATE, DELETE

• Hizmet Sorumlularıyla kimlik doğrulaması

  • <@>ClientID<
  • SECRET: Microsoft Entra uygulama hizmeti asıl anahtarı

• Gereken en düşük RBAC rolleri: Depolama blob verileri katkıda bulunanı veya Depolama blobu veri sahibi

Note

V1 OAuth 2.0 belirteç uç noktasını kullanma

• Yönetilen Kimlik (VNet Hizmet Uç Noktaları) ile kimlik doğrulaması

  • KİmLİk: 'Yönetilen Kimlik' değerine sahip sabit

• Gereken en düşük RBAC rolleri: Microsoft Entra kayıtlı SQL Veritabanı sunucusu için depolama blobu veri katkıda bulunanı veya Depolama blobu veri sahibi

• Microsoft Entra kullanıcısıyla kimlik doğrulaması

  • KIMLIK BILGILERI gerekli değildir

• Gereken en düşük RBAC rolleri: Microsoft Entra kullanıcısı için depolama blob verileri katkıda bulunanı veya Depolama blobu veri sahibi

ERRORFILE_CREDENTIAL ile depolama hesabı anahtarı kullanılması desteklenmez.

Note

ERRORFILE dosyanız için aynı depolama hesabını kullanıyor ve kapsayıcının köküne göre ERRORFILE yolunu belirtiyorsanız, ERROR_CREDENTIAL belirtmeniz gerekmez.

MAXERRORS = max_errors

MAXERRORS, COPY işlemi başarısız olmadan önce yükte izin verilen en fazla reddetme satırı sayısını belirtir. COPY işlemi tarafından içeri aktarılabilen her satır yoksayılır ve tek bir hata olarak sayılır. max_errors belirtilmezse, varsayılan değer 0'dır.

MAXERRORS AUTO_CREATE_TABLE ile kullanılamaz.

FILE_TYPE olduğundaPARQUET, veri türü dönüştürme hatalarından kaynaklanan özel durumlar (örneğin, Parquet ikiliden SQL tamsayısına) hata vermemeye devam COPY INTO eder ve MAXERRORS yoksayılır.

Sıkıştirma = { 'DefaultCodec' | 'Hızlı' | 'GZIP' | 'HİÇİN'}

COMPRESSION isteğe bağlıdır ve dış veriler için veri sıkıştırma yöntemini belirtir.

• CSV, GZIP'i destekler
• Parquet, GZIP ve Snappy'i destekler
• ORC, DefaultCodec ve Snappy'i destekler.
• Zlib, ORC için varsayılan sıkıştırmadır

COPY komutu, bu parametre belirtilmediğinde dosya uzantısına göre sıkıştırma türünü otomatik olarak algılar:

• .gz - GZIP
• .snappy - Çabuk
• .deflate - DefaultCodec (yalnızca Parquet ve ORC)

COPY komutu, gzip dosyalarının normal şekilde çalışması için sondaki çöpleri içermesini gerektirir. gzip biçimi, dosyaların öncesinde, arasında veya sonrasında ek bilgi olmadan geçerli üyelerden oluşmasını kesinlikle gerektirir. Gzip olmayan verilerin varlığı gibi bu biçimden herhangi bir sapma COPY komutunun başarısızlığına neden olur. COPY'nin bu dosyaları başarıyla işleyebilmesini sağlamak için gzip dosyalarının sonunda sondaki çöplerin olmadığından emin olun.

ALAN ALATI = 'field_quote'

FIELDQUOTE CSV için geçerlidir ve CSV dosyasında tırnak karakteri (dize sınırlayıcısı) olarak kullanılan tek bir karakteri belirtir. Belirtilmezse, teklif karakteri (") RFC 4180 standardında tanımlandığı gibi tırnak karakteri olarak kullanılır. FIELDQUOTE için onaltılık gösterimi de desteklenir. FIELDQUOTE için UTF-8 ile genişletilmiş ASCII ve çok baytlı karakterler desteklenmez.

Note

FIELDQUOTE karakterleri, çift FIELDQUOTE (sınırlayıcı) varlığının bulunduğu dize sütunlarında kaçış olarak kullanılır.

FIELDTERMINATOR = 'field_terminator'

FIELDTERMINATOR Yalnızca CSV için geçerlidir. CSV dosyasında kullanılan alan sonlandırıcısını belirtir. Alan sonlandırıcısı onaltılık gösterimi kullanılarak belirtilebilir. Alan sonlandırıcısı çok karakterli olabilir. Varsayılan alan sonlandırıcısı bir (,) şeklindedir. FIELDTERMINATOR için UTF-8 ile genişletilmiş ASCII ve çok baytlı karakterler desteklenmez.

SATIR SONLANDıRıCıSI = 'row_terminator'

ROW TERMINATOR Yalnızca CSV için geçerlidir. CSV dosyasında kullanılan satır sonlandırıcısını belirtir. Satır sonlandırıcısı onaltılık gösterimi kullanılarak belirtilebilir. Satır sonlandırıcısı çok karakterli olabilir. Varsayılan olarak, satır sonlandırıcısı \r\n.

COPY komutu, \rile sonuçlanacak \n (yeni satır) belirtirken \r\n karakterine ön ek ekler. Yalnızca \n karakteri belirtmek için onaltılık gösterimi (0x0A) kullanın. Çok karakterli satır sonlandırıcılarını onaltılık olarak belirtirken, her karakter arasında 0x belirtmeyin.

ROW TERMINATOR için UTF-8 ile genişletilmiş ASCII ve çok baytlı karakterler desteklenmez.

BIRINCI SIRA = First_row_int

FIRSTROW CSV için geçerlidir ve COPY komutu için tüm dosyalarda ilk okunan satır numarasını belirtir. Değerler, varsayılan değer olan 1'den başlar. Değer iki olarak ayarlanırsa, veriler yüklendiğinde her dosyadaki (üst bilgi satırı) ilk satır atlanır. Satır sonlandırıcılarının varlığına bağlı olarak satırlar atlanır.

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

DATEFORMAT yalnızca CSV için geçerlidir ve SQL Server tarih biçimlerine eşleme tarihi biçimini belirtir. Tüm Transact-SQL tarih ve saat veri türlerine ve işlevlerine genel bakış için bkz. Tarih ve Saat Veri Türleri ve İşlevleri (Transact-SQL). COPY komutundaki DATEFORMAT,oturum düzeyinde yapılandırılmış DATEFORMAT'den önceliklidir.

KODLAMA = 'UTF8' | 'UTF16'

KODLAMA yalnızca CSV için geçerlidir. Varsayılan değer UTF8'dir. COPY komutu tarafından yüklenen dosyalar için veri kodlama standardını belirtir.

IDENTITY_INSERT = 'ON' | 'KAPALI'

IDENTITY_INSERT, içeri aktarılan veri dosyasındaki kimlik değerinin veya değerlerinin kimlik sütunu için kullanılıp kullanılmayacağını belirtir. IDENTITY_INSERT KAPALI (varsayılan) ise, bu sütunun kimlik değerleri doğrulanır ancak içeri aktarılmaz. COPY komutuyla aşağıdaki davranışa dikkat edin:

• IDENTITY_INSERT KAPALI ise ve tabloda bir kimlik sütunu varsa
  • Giriş alanını kimlik sütunuyla eşlemeyen bir sütun listesi belirtilmelidir.
• IDENTITY_INSERT AÇıKsa ve tabloda bir kimlik sütunu varsa
  • Sütun listesi geçirilirse, bir giriş alanını kimlik sütununa eşlemesi gerekir.
• Varsayılan değer, sütun listesindeki KİmLİk SÜTUNU için desteklenmez.
• IDENTITY_INSERT aynı anda yalnızca bir tablo için ayarlanabilir.

Azure Synapse Analytics, tablo oluşturma sırasında belirtilen tohum ve artım değerlerine göre otomatik olarak benzersiz değerler atar.

AUTO_CREATE_TABLE = { 'AÇIQ' | 'KAPALI' }

AUTO_CREATE_TABLE, otomatik şema bulma ile birlikte çalışarak tablonun otomatik olarak oluşturulup oluşturulamadığını belirtir. Yalnızca Parquet dosyaları için kullanılabilir.

• ON: Otomatik tablo oluşturmayı etkinleştirir. Süreç, COPY INTO yüklenecek dosyanın yapısını keşfederek otomatik olarak yeni bir tablo oluşturur. Parquet dosyalarının otomatik şema bulma avantajından yararlanmak için önceden var olan tablolarla da kullanılabilir.
• KAPALI: Otomatik tablo oluşturma etkin değil. Default.

Note

Otomatik tablo oluşturma, otomatik şema bulma ile birlikte çalışır. Otomatik tablo oluşturma varsayılan olarak ETKINLEŞTIRILMEZ.

Permissions

COPY komutunu yürüten kullanıcının aşağıdaki izinlere sahip olması gerekir:

• VERITABANı TOPLU İŞLEMLERINI YÖNETME
• INSERT

INSERT ve ADMINISTER BULK OPERATIONS izinleri gerektirir. Azure Synapse Analytics'te INSERT ve ADMINISTER DATABASE BULK OPERATIONS izinleri gereklidir.

Ayrıca COPY komutunu yürüten kullanıcı da yeni bir tablo oluşturmayı ve içine veri yüklemeyi planlıyorsa CREATE TABLE ve ALTER ON SCHEMA izinleri gerektirir.

Örneğin, mike@contoso.comHR şemasında yeni bir tablo oluşturmak ve bir Parquet dosyasından veri eklemek için COPY kullanmasına izin vermek için aşağıdaki Transact-SQL örneğini kullanın:

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

COPY deyimi, satır verileri ve komut parametreleri için yalnızca UTF-8 ve UTF-16 geçerli karakterleri kabul eder. Geçersiz karakterler kullanan kaynak dosyalar veya parametreler (ROW TERMINATOR veya FIELD TERMINATOR gibi) COPY deyimi tarafından yanlış yorumlanabilir ve veri bozulması veya diğer hatalar gibi beklenmeyen sonuçlara neden olabilir. COPY deyimini çağırmadan önce kaynak dosyalarınızın ve parametrelerinizin UTF-8 veya UTF-16 uyumlu olduğundan emin olun.

Sorgu MAXDOP ipucu ile COPY INTOdesteklenmiyor.

Güvenilir yürütmeyi sağlamak için, kaynak dosya ve klasörlerin işlem süresi COPY INTO boyunca değişmeden kalması gerekir.

• Komut çalışırken başvuruda bulunan dosya veya klasörlerin değiştirilmesi, silinmesi veya değiştirilmesi işlemin başarısız olmasına veya tutarsız veri alımına neden olabilir.
• yürütmeden COPY INTOönce tüm kaynak verilerin kararlı olduğunu ve işlem sırasında değiştirilmeyeceğini doğrulayın.

Examples

A. Genel depolama hesabından yükleme

Aşağıdaki örnek, kamu depolama hesabından veri yükleyen komutun en basit biçimidir COPY . Bu örnekte COPY deyiminin varsayılanları, satır öğesi csv dosyasının biçimiyle eşleşmektedir.

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

COPY komutunun varsayılan değerleri şunlardır:

• DATEFORMAT = Oturum DATEFORMAT

• MAXERRORS = 0

• SıKıŞTıRMA varsayılanı sıkıştırılmamış

• FIELDQUOTE = '"'

• FIELDTERMINATOR = ','

• SATIR TERMINATÖR = '\n'

Important

COPY, \n dahili olarak \r\n olarak ele alır. Daha fazla bilgi için ROWTERMINATOR bölümüne bakın.

• BİRİNCİ SIRA = 1

• KODLAMA = 'UTF8'

• FILE_TYPE = 'CSV'

• IDENTITY_INSERT = 'KAPALI'

B. Paylaşım Erişim İmzası (SAS) aracılığıyla yük kimlik doğrulaması

Aşağıdaki örnek, unix çıkışı gibi satır sonlandırıcısı olarak satır akışını kullanan dosyaları yükler. Bu örnek, Azure Blob Depolama'da kimlik doğrulaması yapmak için bir SAS anahtarı da kullanır.

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. Depolama Hesabı Anahtarı aracılığıyla kimlik doğrulaması varsayılan değerleri içeren bir sütun listesiyle yükleme

Bu örnek, varsayılan değerlerle bir sütun listesi belirten dosyaları yükler.

--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>'),
    --CREDENTIAL should look something like this:
    --CREDENTIAL=(IDENTITY= 'Storage Account Key', SECRET='x6RWv4It5F2msnjelv3H4DA80n0PQW0daPdw43jM0nyetx4c6CpDkdj3986DX5AHFMIf/YN4y6kkCnU8lb+Wx0Pj+6MDw=='),
    FIELDQUOTE = '"',
    FIELDTERMINATOR=',',
    ROWTERMINATOR='0x0A',
    ENCODING = 'UTF8',
    FIRSTROW = 2
)

D. Mevcut dosya biçimi nesnesini kullanarak Parquet veya ORC yükleme

Bu örnekte, tüm Parquet dosyalarını bir klasörün altına yüklemek için joker karakter kullanılır.

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. Joker kartları ve birden çok dosyayı belirtmeyi yükleme

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. MSI kimlik bilgilerini kullanarak yükleme

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. Otomatik şema algılama kullanarak yükleme

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'
)

FAQ

COPY komutunun PolyBase ile karşılaştırıldığında performansı nedir?

COPY komutu, iş yükünüze bağlı olarak daha iyi performansa sahiptir.

• Sıkıştırılmış dosyalar otomatik olarak bölünemez. En iyi yükleme performansı için sıkıştırılmış CSV'leri yüklerken girişinizi birden çok dosyaya bölmeyi göz önünde bulundurun.

• Büyük sıkıştırılmamış CSV dosyaları otomatik olarak bölünebilir ve paralel olarak yüklenebilir, bu nedenle çoğu durumda sıkıştırılmamış CSV dosyalarını el ile bölmeniz gerekmez. Veri özellikleri nedeniyle otomatik dosya bölmenin mümkün olmadığı bazı durumlarda, büyük CSV'lerin el ile bölünmesi performansa hala fayda sağlayabilir.

Sıkıştırılmış CSV dosyalarını yüken COPY komutu için dosya bölme kılavuzu nedir?

Dosya sayısıyla ilgili yönergeler aşağıdaki tabloda özetlenmiştir. Önerilen dosya sayısına ulaşıldığında, dosyalar ne kadar büyük olursa o kadar iyi bir performans elde etmiş olursunuz. Dosya sayısı, 60 ile çarpılan işlem düğümü sayısına göre belirlenir. Örneğin, 6000DWU'da 12 işlem düğümü ve 12*60 = 720 bölüm vardır. Basit bir dosya bölme deneyimi için dosya bölmeleriyle COPY yük aktarım hızını en üst düzeye çıkarma bölümüne bakın.

DWU	#Files
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

Parquet veya ORC dosyalarını yüken COPY komutu için dosya bölme kılavuzu nedir?

COPY komutu dosyaları otomatik olarak böldüğünden Parquet ve ORC dosyalarını bölmeye gerek yoktur. En iyi performans için Azure depolama hesabındaki Parquet ve ORC dosyaları 256 MB veya daha büyük olmalıdır.

Dosyaların sayısı veya boyutuyla ilgili herhangi bir sınırlama var mı?

Dosyaların sayısı veya boyutuyla ilgili herhangi bir sınırlama yoktur; ancak en iyi performans için en az 4 MB olan dosyaları öneririz. Ayrıca, daha iyi performans için kaynak dosya sayısını en fazla 5.000 dosyayla sınırlayın.

COPY deyimiyle ilgili bilinen sorunlar var mı?

7 Aralık 2020'den önce oluşturulmuş bir Azure Synapse çalışma alanınız varsa, Yönetilen Kimlik kullanarak kimlik doğrulaması yaparken benzer bir hata iletisiyle karşılaşabilirsiniz: com.microsoft.sqlserver.jdbc.SQLServerException: Managed Service Identity has not been enabled on this server. Please enable Managed Service Identity and try again.

Çalışma alanının yönetilen kimliğini yeniden kaydederek bu sorunu geçici olarak çözmek için şu adımları izleyin:

1. Azure PowerShell'i yükleyin. PowerShellyükleme bakın.
2. PowerShell kullanarak çalışma alanınızın yönetilen kimliğini kaydedin:

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

İlgili içerik

• Azure Synapse Analytics ile yüklemeye genel bakış