Aracılığıyla paylaş


SQL belgeleri için sürüm oluşturma sistemi

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure Synapse AnalyticsAnalytics Platform Sistemi (PDW)

Bu makalede SQL belgeleri için sürüm oluşturma sistemimiz açıklanmaktadır. Sürüm oluşturma sistemi, ürünleri ve sürümlerini bilir. Sistem, ilgilendiğiniz ürünü ve sürümü seçmenizi sağlar. Sistem daha sonra uygun belgeleri görüntüler.

Ürünler için geçerlidir

SQL Server makalelerinin çoğunda başlığı altında Uygulandığı sözcükler bulunur. Aynı satırda, makalenin ürünle ilgili olup olmadığının göstergelerini içeren kullanışlı bir SQL ürünleri listesi bulunur. Örneğin, ürün SQL Server ilgili olarak, Azure SQL Veritabanı ise makaleyle ilgisiz olarak gösterilebilir.

Aşağıdakiler için geçerlidir satırı, ürünlerin sürümleri hakkında bilgi vermez. Sürüm oluşturma sistemi yapılandırmalarımızın Satır ve ürün açıları arasındaki tutarsızlıkları önlemeye çalışıyoruz.

Ayrı dosya kümelerinin geçmişi

SQL Server 2014 ve önceki sürümler için her sürüm, belge dosyalarının kendi tam ayrı kopyasına sahiptir. Örneğin, SQL Server 2014 belgeleri SQL Server 2012 belgelerinin bir kopyası olarak başladı. 2014 kopyası daha sonra ürün geliştirme döngüsü sırasında düzenlenmiştir.

Bu eski yaklaşım, 2014 belgelerinde bir kusur bulunması durumunda, kusur 2012 ve 2008'de de mevcut olabileceği anlamına geliyordu. Bu, kusurları düzeltmeyi ve genel bakımı daha zor hale getirdi.

Aynı dosyalarda birden çok sürüm

Bu nedenle ve diğerleri için SQL Server 2016 belge dosyaları da 2017, 2019 ve büyük olasılıkla vNext< içindir>. Artık SQL Server belge dosyalarımıza sürüm oluşturma takma adlarını atadığımız için bu birleştirme pratik hale getirildi. Sürüm oluşturma adlar, verilen her belge dosyası için herhangi bir ayrıntı düzeyinde atanır veya açıkça eklenir.

Kullanıcı arabiriminde sürüm oluşturma denetimi

Web sitemizi Docs kullanarak herhangi bir SQL belgeleri makalesini görüntülediğinizde, şu anda seçilen sürüm oluşturma adı içindekiler tablosunun (İçindekiler Tablosu) üzerinde görünür. Denetim bir açılan listedir.

media_versioning-control-10-sql-server-2017.png

SQL Server'ın farklı bir sürümünün belgelerini görmek istiyorsanız, geçerli sürüm takma adı sonunda bulunan genişletici okunu seçersiniz. Ardından istediğiniz ürün ve sürüm birleşimini seçmek için öğesini seçin. Farklı bir sürüm seçtiğinizde, görüntülenen belgeler aniden yeni seçilen sürüme ilişkin farkları gösterecek şekilde değişir. Herhangi bir değişiklik olabilir veya olmayabilir ve her iki durum da yaygındır.

media_versioning-control-20-expanded.png

HTTPS parametresi view=

Web adresi ile https://learn.microsoft.com/sql/ başlayan her makalenin adresine eklenmiş adlı ?view= bir parametresi vardır. Bu parametre değeri, sürüm oluşturma takma adı kodudur.

Adresteki takma ad https her zaman sürüm oluşturma denetiminde görüntülenen takma adla eşleşir.

Sürümler değil ürünler

Edisyonlar

1990'larda ve 2000'lerde Microsoft SQL Server'ın tek bir ürünü vardı. SQL Server 2008'in Developer ve Enterprise sürümleri gibi her SQL Server sürümünün çeşitli sürümleri vardı. Sürümler biraz farklı özellik kümelerini temsil etti, ancak çekirdek ürün aynıydı. Yeni SQL Server sürümleri yine de çeşitli sürümlere sahip olabilir.

Products

Bulut bilişimin ve Microsoft Azure'ın daha yeni artmasıyla Microsoft, Azure SQL Veritabanı ürününü piyasaya çıkardı. Hem geleneksel SQL Server şirket içi ürünü hem de Azure SQL Veritabanı ürünü tarafından paylaşılan çok fazla kod olsa da, bu ürünler gerçekten ayrı iki ürün.

SQL için sürüm oluşturma takma adları ürünler arasında ayrım yapar ancak sürümler arasında ayrım yapmaz.

Azure bulut SQL ürünleri

Makalelerde web adreslerinin tamamı ile https://learn.microsoft.com/sql/başlar. Neredeyse tümü ürünün SQL Server adlı en az bir sürümü için geçerlidir. Bu makalelerin büyük bir alt kümesi, Azure bulutumuzda barındırılan bir veya daha fazla SQL hizmeti ürünümüz için de geçerlidir. Bu tür bir SQL bulut ürününe Azure SQL Veritabanı adı verilmiştir.

Doğal olarak, Azure SQL Veritabanı ürününün yalnızca bir sürümü vardır. Azure SQL Veritabanı için geçerli olan ancak SQL Server için geçerli olmayan makalelerin hemen hemen tümü ile https://learn.microsoft.com/azure/sql-database/başlayan web adreslerine sahiptir.

Sürüm filtreleme senaryoları

Sürüm oluşturma sistemi, şu anda etkin olan takma ad için geçerli olmayan tüm belge içeriğini filtreleyerek çalışır. Farklı bir sürüm oluşturma adı seçtiğinizde, gizli değişiklikler içeren içerik kümesi. Filtreleme, içeriği aşağıdaki düzeylerde gizler:

  • Bir makalenin içindeki bölümler veya cümleler.
  • İçindekiler tablosundaki (İçindekiler tablosu) makaleler için girişler.

Bundan sonra farklı bir takma ad seçmenin etkilerini açıklayan senaryolar yer alır.

Senaryo 1: Geçerli makalenin içinde

Aşağıdaki senaryo, geçerli makalenizin bölümlerine odaklanır:

  1. Geçerli sürüm oluşturma adı SQL Server 2017'dir.
  2. SQL Server'ın 2017 sürümüne ilk eklenen özelliği açıklayan bölümü okuyorsunuz.
  3. Takma adı SQL Server 2016 olarak değiştirirsiniz.
  4. Okuduğun bölümün gittiğini fark ettin.
  5. Bu kez sql server 2019 olarak bilinen adı yeniden değiştirin.
  6. Okuduğun 2017 bölümünün yeniden görüntülendiğini fark ettin.

Önceki senaryoda, yeni 2017 özelliğiyle ilgili bölüm büyük olasılıkla aşağıdaki takma adı kodunu içeren bir takma ad aralığıyla işaretlenmiştir:

  • >=sql-server-2017

Sql Server 2019 adı seçildiğinde, sürüm oluşturma sistemi 2019'un 2017'den büyük veya eşittir olduğunu fark etti ve bölümü görüntüledi.

Senaryo 2: Gizli bir makalenin bağlantısını seçme

Aşağıdaki yaygın olmayan senaryoda, içindekiler tablosundan (İçindekiler Tablosu) gizli olan bir makalenin bağlantısını seçtiğinizde ne olacağı açıklanmaktadır. Kısaca, bağlantı çalışır:

  1. Geçerli sürüm oluşturma adı SQL Server 2017'dir.
  2. Geçerli makalede A, yalnızca SQL Server 2016 için geçerli olan bir makalenin B bağlantısını seçersiniz.
    • Seçimden önce içindekiler tablosunda makalenin B girişi gizlidir.
  3. Seçimden sonra makale B görüntülenir.
    • Makalenin B görüntülenmesi, sürüm oluşturma denetimini SQL Server 2016 takma adıyla geçiş yapmaya zorlar.
    • Çünkü özgün sql server 2017 bilinen adı terk edilmesi gerekiyordu. Bu bırakma, bilgi içeren bir iletinin web sayfasının üst kısmında görüntülenmesine neden olur. İleti, yeni makaleye Buyum sağlamak için geçerli takma adın değiştirilmesi gerektiğini açıklar.

Senaryo 3: Https adresine gitme

Aşağıdaki makale SQL Server 2017 için yeni eklendi. Makalede, SQL Server'a sürüm 2017'de eklenen özellikler açıklanmaktadır. Bu yeni özelliklerin çoğu veya tümü de sürüm 2019'un bir parçasıdır. Makalenin öznitelikleri aşağıda verilmiştir.

Özellik Değer
Başlık SQL Server 2017'deki yenilikler
ad aralığı =">= sql-server-2017"
https adres https://learn.microsoft.com/sql/sql-server/what-s-new-in-sql-server-2017

Temel https adres göz önünde bulundurulduğunda, aşağıdaki tabloda parametre kullanıcı tarafından eklendiğinde ?view= ve çeşitli değerlerle ne olacağı açıklanmaktadır.

Değeri ?view= Adres gezintisinin https davranışı
(Parametre yok) Sürüm oluşturma sistemi varsayılan takma adını dener. Genellikle bunu SQL Server'ın Önizleme olmayan en son sürümüne ayarlarız.

SQL Server 2017 veya 2019 varsayılanı özniteliğini >= sql-server-2017karşılar.

Sistem, parametresini adresin https sonuna (belki de olarak ?view=sql-server-2017) ekler.
Sürüm oluşturma açılan listesi denetimi daha sonra eşleştirme adı olarak ayarlanır.
sql-server-2016 Sürüm oluşturma sistemi, makalenin bilinen aralığının 2016 sürümünü içermediğini fark eder.

Sistem daha sonra aralığı karşılayan takma adlardan birini seçer.

Ardından sürüm 2016 örneğinde olduğu gibi parametresi ?view= eklenir ve denetim adı parametre değeriyle eşleşer.
sql-server-2017 Sürüm oluşturma sistemi, parametre değerinin makalenin bilinen aralığına dahil olduğunu anlar.

Sürüm oluşturma denetimi parametre değeriyle eşleşecek şekilde ayarlanır.
sql-server-2019 parametresi ve denetimin 2019 olarak ayarlanması dışında, değerin sql-server-2017durumuyla aynıdır.

Tüm SQL - Hiçbir şeyi gizleme, özel takma ad

Tüm SQL'in bir özel bilinen ürün adı vardır ve tek sürümü Hiçbir şeyi gizlemedir. Bu takma adın amacı, belirli değişikliklerin iç test edilmesi içindir. Bir müşteri tarafından kullanılırsa, bu takma adın bilgi vermekten çok yanlış yönlendirme olasılığı daha yüksektir.

Bazı makalelerde SQL Server'ın birden çok sürümüyle ilgili bilgiler bulunur. Her normal takma ad, başka türlü bilinen adın sürümü için yanlış, kafa karıştırıcı veya çelişkili bilgileri görüntüleyebilen sürümlenmiş bölümleri gizler. Özel All SQL bilinen adı tüm sürüm bölümlerini görüntüler ve yanlış bilgilerin görüntülendiği açıkça belli olmayabilir.

İleti: İstenen sayfa bilinen ad için <kullanılamıyor>

Aşağıdaki senaryo, web sayfasının üst kısmına yakın bir bilgi iletisi görüntülenmesine Docs yol açar:

  1. Şu anda sürüm oluşturma adı SQL Server 2017'dir.
  2. SQL Server 2017 ile ilgili bir makale okuyorsunuz.
    • Makale, Azure SQL Veritabanı ürünüyle ilgili değildir .
  3. Bilinen adı Azure SQL Veritabanı - geçerli olarak değiştirmeyi denersiniz.
  4. Denemenizin reddedildiğini ve bir ileti görüntülendiğini görürsünüz.

Bu senaryonun sonunda, Docs web sayfasının üst kısmında aşağıdaki bilgilendirme iletisini görürsünüz:

İstenen sayfa Azure SQL Veritabanı için kullanılamıyor - geçerli. Bu sayfanın kullanılabilmesi için en yeni ürün sürümüne yönlendirildiniz.

En yeni sürüm henüz tam olarak yayımlanmamış ve Önizleme durumunda olan sürümleri dışlayabilir.

media_versioning-control-30-viewfallbackfrom.png

SQL Server'ın önceki sürümleri

Sürüm oluşturma sistemi, SQL Server sürüm 2016 için tam olarak uygulandı.