Bagikan melalui


Sistem penerapan versi untuk dokumentasi SQL

Berlaku untuk: SQL ServerAzure SQL DatabaseAzure Synapse Analytics Analytics Platform System (PDW)

Artikel ini menjelaskan sistem penerapan versi kami untuk dokumentasi SQL. Sistem penerapan versi tahu tentang produk dan versinya. Sistem ini memungkinkan Anda memilih produk dan versi yang Anda minati. Sistem kemudian menampilkan dokumentasi yang sesuai.

Berlaku untuk produk

Sebagian besar artikel SQL Server memiliki kata-kata Berlaku untuk di bawah judulnya. Pada baris yang sama, ada daftar produk SQL yang berguna dengan indikator apakah artikel tersebut relevan dengan produk. Misalnya, produk SQL Server dapat ditunjukkan sebagai relevan, sementara Azure SQL Database dapat ditunjukkan sebagai tidak relevan dengan artikel.

Berlaku untuk baris tidak tahu tentang versi produk. Kami berusaha untuk menghindari perbedaan antara berlaku untuk lini dan aspek produk dari konfigurasi sistem penerapan versi kami.

Riwayat set file terpisah

Untuk SQL Server 2014 dan versi yang lebih lama, setiap versi memiliki salinan lengkap file dokumentasi terpisah. Misalnya, dokumentasi untuk SQL Server 2014 dimulai sebagai salinan dokumentasi untuk SQL Server 2012. Salinan 2014 kemudian diedit selama siklus pengembangan produk.

Pendekatan lama ini berarti bahwa jika kelemahan ditemukan dalam dokumentasi 2014, kelemahan mungkin juga ada pada tahun 2012 dan 2008. Ini membuat memperbaiki kelemahan dan pemeliharaan umum lebih sulit.

Beberapa versi dalam file yang sama

Untuk alasan ini dan lainnya, file dokumentasi untuk SQL Server 2016 juga untuk 2017, 2019, dan mungkin untuk <vNext>. Konsolidasi ini dibuat praktis karena kami sekarang menetapkan moniker penerapan versi ke file dokumentasi SQL Server kami. Moniker penerapan versi ditetapkan, atau secara eksplisit disematkan, pada tingkat granularitas apa pun yang masuk akal untuk setiap file dokumentasi yang diberikan.

Kontrol penerapan versi di UI

Saat Anda melihat artikel dokumentasi SQL dengan menggunakan situs web kami Docs , moniker penerapan versi yang saat ini dipilih terlihat di atas daftar isi (TOC). Kontrol adalah daftar drop-down.

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

Jika Anda ingin melihat dokumentasi untuk versi SQL Server yang berbeda, Anda mengklik panah perluas yang terletak di akhir moniker versi saat ini. Lalu klik untuk memilih kombinasi produk dan versi apa pun yang Anda inginkan. Saat Anda mengklik versi yang berbeda, dokumentasi yang ditampilkan tiba-tiba berubah untuk menunjukkan perbedaan untuk versi yang baru dipilih. Mungkin ada atau mungkin tidak ada perubahan apa pun, dan kedua kasus itu umum.

media_versioning-control-20-expanded.png

Parameter HTTPS view=

Setiap artikel yang alamat webnya dimulai dengan https://learn.microsoft.com/sql/ memiliki parameter bernama ?view= ditambahkan ke alamatnya. Nilai parameter ini adalah kode moniker penerapan versi.

Kode moniker di https alamat selalu cocok dengan nama moniker yang ditampilkan dalam kontrol penerapan versi.

Produk, bukan edisi

Edisi

Pada tahun 1990-an dan pada tahun 2000-an, Microsoft SQL Server hanya memiliki satu produk. Ada berbagai edisi dari setiap versi SQL Server, seperti edisi Pengembang dan Perusahaan SQL Server 2008. Edisi mewakili set fitur yang sedikit berbeda, tetapi produk intinya sama. Rilis SQL Server baru mungkin masih memiliki berbagai edisi.

Produk

Dengan meningkatnya komputasi cloud dan Microsoft Azure yang lebih baru, Microsoft merilis produk Azure SQL Database-nya. Meskipun ada banyak kode yang dibagikan oleh produk lokal SQL Server tradisional dan produk Azure SQL Database, produk ini adalah dua produk yang benar-benar terpisah.

Untuk SQL, penerapan versi moniker membuat perbedaan antara produk, tetapi tidak di antara edisi.

Produk Azure cloud SQL

Untuk artikel, seluruh alamat web dimulai dengan https://learn.microsoft.com/sql/, hampir semua berlaku untuk setidaknya satu versi produk bernama SQL Server. Subset besar dari artikel tersebut juga berlaku untuk satu atau beberapa produk layanan SQL kami yang dihosting di cloud Azure kami. Salah satu produk cloud SQL tersebut diberi nama Azure SQL Database.

Secara alami, produk Azure SQL Database hanya memiliki satu versi. Hampir semua artikel yang berlaku untuk Azure SQL Database, tetapi tidak ke SQL Server, memiliki alamat web yang dimulai dengan https://learn.microsoft.com/azure/sql-database/.

Skenario pemfilteran versi

Sistem penerapan versi bekerja dengan memfilter semua konten dokumentasi yang tidak berlaku untuk moniker aktif saat ini. Setiap kali Anda memilih moniker penerapan versi yang berbeda, sekumpulan konten yang disembunyikan berubah. Pemfilteran menyembunyikan konten pada tingkat berikut:

  • Bagian atau kalimat dalam artikel.
  • Entri untuk artikel dalam daftar isi (TOC).

Selanjutnya adalah skenario yang menjelaskan efek memilih moniker yang berbeda.

Skenario 1: Dalam artikel saat ini

Skenario berikut berfokus pada bagian dalam artikel Anda saat ini:

  1. Moniker penerapan versi saat ini adalah SQL Server 2017.
  2. Anda membaca bagian yang menjelaskan fitur yang pertama kali ditambahkan ke SQL Server versi 2017.
  3. Anda mengubah moniker ke SQL Server 2016.
  4. Anda melihat bagian yang Anda baca sudah hilang.
  5. Anda kembali mengubah moniker, kali ini ke SQL Server 2019.
  6. Anda melihat bagian 2017 yang Anda baca kembali ditampilkan.

Dalam skenario sebelumnya, bagian tentang fitur 2017 baru kemungkinan ditandai dengan rentang moniker yang menyertakan kode moniker berikut:

  • >=sql-server-2017

Ketika moniker SQL Server 2019 dipilih, sistem penerapan versi menyadari bahwa 2019 lebih besar dari atau sama dengan 2017, dan menampilkan bagian tersebut.

Skenario 2: Klik tautan ke artikel tersembunyi

Skenario yang jarang terjadi berikut menjelaskan apa yang terjadi jika Anda mengklik tautan ke artikel yang saat ini disembunyikan dari daftar isi (TOC). Singkatnya, tautan berfungsi:

  1. Moniker penerapan versi saat ini adalah SQL Server 2017.
  2. Dalam artikel Asaat ini , Anda mengklik tautan ke artikel B yang hanya berlaku untuk SQL Server 2016.
    • Sebelum klik, daftar isi memiliki entrinya untuk artikel B tersembunyi.
  3. Setelah klik, artikel B ditampilkan.
    • Tampilan artikel B memaksa kontrol penerapan versi untuk beralih ke moniker SQL Server 2016 .
    • Karena moniker asli SQL Server 2017 harus ditinggalkan. Pengabaian ini menyebabkan pesan informasi ditampilkan di dekat bagian atas halaman web. Pesan menjelaskan bahwa moniker saat ini harus dialihkan untuk mengakomodasi artikel Bbaru .

Skenario 3: Menavigasi ke alamat https

Artikel berikut ini ditambahkan baru untuk SQL Server 2017. Artikel ini menjelaskan fitur yang ditambahkan ke SQL Server dalam versi 2017. Sebagian besar atau semua fitur baru tersebut juga merupakan bagian dari versi 2019. Berikut adalah atribut artikel.

Atribut Nilai
Judul Apa yang baru di SQL Server 2017
rentang moniker =">= sql-server-2017"
https alamat https://learn.microsoft.com/sql/sql-server/what-s-new-in-sql-server-2017

Mengingat alamat dasar https , tabel berikut menjelaskan apa yang terjadi ketika ?view= parameter ditambahkan oleh pengguna, dan dengan berbagai nilai.

nilai ?view= https Perilaku navigasi alamat
(Tidak ada parameter.) Sistem penerapan versi akan mencoba nilai moniker defaultnya. Biasanya kita mengatur ini ke versi non-Pratinjau terbaru dari SQL Server.

Default SQL Server 2017 atau 2019 akan memenuhi atribut >= sql-server-2017.

Sistem akan menambahkan parameter ke https alamat, mungkin sebagai ?view=sql-server-2017.
Kontrol daftar drop-down penerapan versi kemudian akan diatur ke nama moniker yang cocok.
sql-server-2016 Sistem penerapan versi akan menyadari bahwa rentang moniker artikel tidak menyertakan versi 2016.

Sistem kemudian akan memilih salah satu moniker yang memenuhi rentang.

Kemudian seperti dalam kasus versi 2016, parameter ?view= akan ditambahkan, dan nama kontrol akan cocok dengan nilai parameter.
sql-server-2017 Sistem penerapan versi memahami bahwa nilai parameter disertakan dalam rentang moniker artikel.

Kontrol penerapan versi akan diatur agar sesuai dengan nilai parameter.
sql-server-2019 Sama seperti untuk kasus nilai sql-server-2017, kecuali parameter dan kontrol diatur ke 2019.

Semua SQL - Sembunyikan apa-apa, moniker khusus

Ada satu nama produk moniker khusus dari Semua SQL, dan satu-satunya versinya adalah Sembunyikan apa pun. Tujuan dari moniker ini adalah untuk pengujian internal perubahan tertentu. Jika digunakan oleh pelanggan, moniker ini lebih mungkin menyesatkan daripada menginformasikan.

Beberapa artikel memiliki informasi yang berkaitan dengan beberapa versi SQL Server. Setiap moniker reguler menyembunyikan bagian versi yang dapat menampilkan informasi yang tidak akurat, membingungkan, atau bertentangan untuk versi moniker. Moniker All SQL khusus akan menampilkan semua bagian versi, dan mungkin tidak jelas bahwa informasi yang tidak akurat sedang ditampilkan.

Pesan: Halaman yang diminta tidak tersedia untuk <moniker>

Skenario berikut mengarah ke tampilan pesan informasi di dekat bagian Docs atas halaman web:

  1. Saat ini moniker penerapan versi adalah SQL Server 2017.
  2. Anda membaca artikel yang relevan dengan SQL Server 2017.
    • Artikel ini tidak relevan dengan produk Azure SQL Database.
  3. Anda mencoba mengubah moniker ke Azure SQL Database - saat ini.
  4. Anda melihat upaya Anda ditolak, dan pesan ditampilkan.

Di akhir skenario ini, Anda akan melihat pesan informasi berikut ditampilkan di dekat bagian atas halaman web Dokumen:

Halaman yang diminta tidak tersedia untuk Azure SQL Database - saat ini. Anda telah dialihkan ke versi produk lebih baru yang tersedia di halaman ini.

Versi terbaru mungkin mengecualikan versi yang belum sepenuhnya dirilis dan berada dalam status Pratinjau .

media_versioning-control-30-viewfallbackfrom.png

Versi SQL Server sebelumnya

Sistem penerapan versi sepenuhnya diimplementasikan untuk SQL Server versi 2016 dan seterusnya.

  • 2012 dan yang lebih lama: Sistem penerapan versi tidak digunakan untuk SQL Server 2012 atau versi yang lebih lama.

    • Moniker khusus SQL Server - yang lebih lama dimaksudkan untuk menyembunyikan hampir semua artikel. Pengecualian langka adalah beberapa artikel yang mungkin diperlukan pelanggan versi lama sekali.
    • Versi SQL Server sebelumnya, 2012-2005
  • 2014: Sistem penerapan versi setengah diterapkan untuk SQL Server 2014. Anda dapat memilih SQL Server 2014 dalam kontrol penerapan versi, dan berfungsi. Namun secara internal file untuk 2014 didedikasikan untuk hanya 2014, dengan cara yang sama file untuk 2008 didedikasikan untuk hanya 2008.

  • 2016 dan yang lebih baru: Sistem penerapan versi sepenuhnya diimplementasikan untuk SQL Server 2016 dan versi yang lebih baru.

Lihat juga

Versi SQL Server sebelumnya, 2014-2005
Panduan navigasi dokumen SQL Server
Cara berkontribusi pada Dokumentasi SQL Server