การค้นหาที่กำหนดค่าได้ (cquery)

รายงานปัญหา ดูแหล่งที่มา

cquery เป็นตัวแปรของ query ที่จัดการ select() และเอฟเฟกต์ของตัวเลือกบิลด์ในกราฟบิลด์ได้อย่างถูกต้อง

โซลูชันนี้ทำได้โดยนำผลลัพธ์ในระยะการวิเคราะห์ของ Bazel มาใช้ ซึ่งผสานรวมเอฟเฟกต์เหล่านี้เข้าด้วยกัน ในทางตรงกันข้าม query จะแสดงบนผลลัพธ์ของระยะการโหลดของ Bazel ก่อนที่จะประเมินตัวเลือก

เช่น

$ cat > tree/BUILD <<EOF
sh_library(
    name = "ash",
    deps = select({
        ":excelsior": [":manna-ash"],
        ":americana": [":white-ash"],
        "//conditions:default": [":common-ash"],
    }),
)
sh_library(name = "manna-ash")
sh_library(name = "white-ash")
sh_library(name = "common-ash")
config_setting(
    name = "excelsior",
    values = {"define": "species=excelsior"},
)
config_setting(
    name = "americana",
    values = {"define": "species=americana"},
)
EOF

# Traditional query: query doesn't know which select() branch you will choose,
# so it conservatively lists all of possible choices, including all used config_settings.
$ bazel query "deps(//tree:ash)" --noimplicit_deps
//tree:americana
//tree:ash
//tree:common-ash
//tree:excelsior
//tree:manna-ash
//tree:white-ash

# cquery: cquery lets you set build options at the command line and chooses
# the exact dependencies that implies (and also the config_setting targets).
$ bazel cquery "deps(//tree:ash)" --define species=excelsior --noimplicit_deps
//tree:ash (9f87702)
//tree:manna-ash (9f87702)
//tree:americana (9f87702)
//tree:excelsior (9f87702)

ผลลัพธ์แต่ละรายการจะมีตัวระบุที่ไม่ซ้ำกัน (9f87702) ของการกำหนดค่าที่เป้าหมายสร้างขึ้น

เนื่องจาก cquery ทำงานบนกราฟเป้าหมายที่กำหนดค่าไว้ จึงไม่มีข้อมูลเชิงลึกในอาร์ติแฟกต์ เช่น การทำงานของบิลด์หรือสิทธิ์เข้าถึงกฎ test_suite เนื่องจากไม่ได้รับการกำหนดค่าเป้าหมาย สำหรับเวอร์ชันเดิม โปรดดู aquery

ไวยากรณ์พื้นฐาน

การเรียก cquery ง่ายๆ มีลักษณะดังนี้

bazel cquery "function(//target)"

นิพจน์ข้อความค้นหา "function(//target)" ประกอบด้วยข้อมูลต่อไปนี้

  • function(...) คือฟังก์ชันที่จะเรียกใช้ในเป้าหมาย cquery รองรับฟังก์ชันส่วนใหญ่ของ query รวมไปถึงฟังก์ชันใหม่ 2-3 รายการ
  • //target คือนิพจน์ที่ป้อนลงในฟังก์ชัน ในตัวอย่างนี้ นิพจน์เป็นเป้าหมายที่เรียบง่าย แต่ภาษาของการค้นหาก็อนุญาตให้มีการซ้อนฟังก์ชันได้เช่นกัน โปรดดูคำแนะนำในการค้นหาเพื่อดูตัวอย่าง

cquery ต้องมีเป้าหมายจึงจะทำงานผ่านช่วงการโหลดและการวิเคราะห์ได้ cquery จะแยกวิเคราะห์เป้าหมายที่แสดงในนิพจน์การค้นหา เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดู --universe_scope สำหรับการค้นหาทรัพยากร Dependency ของเป้าหมายบิลด์ระดับบนสุด

การกำหนดค่า

บรรทัด:

//tree:ash (9f87702)

หมายความว่า //tree:ash สร้างขึ้นในการกำหนดค่าที่มีรหัส 9f87702 สำหรับเป้าหมายส่วนใหญ่ นี่คือแฮชแบบทึบของค่าตัวเลือกบิลด์ที่กำหนดการกำหนดค่า

หากต้องการดูเนื้อหาทั้งหมดของการกำหนดค่า ให้เรียกใช้คำสั่งต่อไปนี้

$ bazel config 9f87702

9f87702 เป็นคำนำหน้าของรหัสแบบเต็ม เนื่องจากรหัสที่สมบูรณ์เป็นแฮช SHA-256 ซึ่งยาวและติดตามได้ยาก cquery เข้าใจคำนำหน้าที่ถูกต้องของรหัสที่สมบูรณ์ คล้ายกับแฮชสั้นๆ หากต้องการดูรหัสทั้งหมด ให้เรียกใช้ $ bazel config

การประเมินรูปแบบเป้าหมาย

//foo มีความหมายว่า cquery ต่างจาก query ทั้งนี้เนื่องจาก cquery ประเมินเป้าหมายที่กำหนดค่าไว้ และกราฟบิลด์อาจมี //foo เวอร์ชันที่กำหนดค่าไว้หลายเวอร์ชัน

สำหรับ cquery รูปแบบเป้าหมายในนิพจน์การค้นหาจะประเมินเป้าหมายที่กำหนดค่าทั้งหมดโดยมีป้ายกำกับที่ตรงกับรูปแบบดังกล่าว ผลลัพธ์เป็นสิ่งที่มีการกำหนดไว้ แต่ cquery ไม่ได้ให้การรับประกันการจัดลำดับที่นอกเหนือจากสัญญาการเรียงลำดับการค้นหาหลัก

ซึ่งให้ผลลัพธ์ที่ดีกว่าสำหรับนิพจน์คำค้นหามากกว่า query ตัวอย่างต่อไปนี้อาจมีผลลัพธ์หลายรายการ

# Analyzes //foo in the target configuration, but also analyzes
# //genrule_with_foo_as_tool which depends on an exec-configured
# //foo. So there are two configured target instances of //foo in
# the build graph.
$ bazel cquery //foo --universe_scope=//foo,//genrule_with_foo_as_tool
//foo (9f87702)
//foo (exec)

หากต้องการประกาศอินสแตนซ์ที่จะค้นหาอย่างแม่นยำ ให้ใช้ฟังก์ชัน config

ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบเป้าหมายได้ในเอกสารประกอบเกี่ยวกับรูปแบบเป้าหมายของ query

ฟังก์ชัน

จากชุดฟังก์ชัน ที่ query รองรับ cquery รองรับทั้งหมด ยกเว้น visible, siblings, buildfiles และ tests

cquery ยังมีฟังก์ชันใหม่ต่อไปนี้อีกด้วย

การกำหนดค่า

expr ::= config(expr, word)

โอเปอเรเตอร์ config จะพยายามค้นหาเป้าหมายที่กำหนดค่าไว้สำหรับป้ายกำกับซึ่งระบุโดยอาร์กิวเมนต์แรกและการกำหนดค่าที่ระบุโดยอาร์กิวเมนต์ที่สอง

ค่าที่ถูกต้องสำหรับอาร์กิวเมนต์ที่ 2 คือ null หรือแฮชการกำหนดค่าที่กำหนดเอง คุณสามารถดึงข้อมูลแฮชจาก $ bazel config หรือเอาต์พุตของ cquery ก่อนหน้า

ตัวอย่าง

$ bazel cquery "config(//bar, 3732cc8)" --universe_scope=//foo

$ bazel cquery "deps(//foo)"
//bar (exec)
//baz (exec)

$ bazel cquery "config(//baz, 3732cc8)"

ถ้าไม่พบผลลัพธ์ของอาร์กิวเมนต์แรกทั้งหมดในการกำหนดค่าที่ระบุ ระบบจะแสดงผลเฉพาะอาร์กิวเมนต์ที่พบเท่านั้น หากไม่พบผลลัพธ์ในการกำหนดค่าที่ระบุ การค้นหาจะล้มเหลว

ตัวเลือก

ตัวเลือกบิลด์

cquery ทำงานบนบิลด์ Bazel ปกติและด้วยเหตุนี้จึงได้รับชุดตัวเลือกที่ใช้ได้ระหว่างบิลด์

การใช้ตัวเลือก cquery

--universe_scope (รายการที่คั่นด้วยจุลภาค)

บ่อยครั้งที่ทรัพยากร Dependency ของเป้าหมายที่กําหนดค่าไว้ต้องดําเนินการผ่านการเปลี่ยน ซึ่งทำให้การกําหนดค่าต่างจากการอ้างอิง แฟล็กนี้ทำให้คุณค้นหาเป้าหมายได้ราวกับว่าเป้าหมายนั้นสร้างขึ้นเป็นทรัพยากร Dependency หรือการพึ่งพาเป้าหมายทางอ้อมของเป้าหมายอื่น เช่น

# x/BUILD
genrule(
     name = "my_gen",
     srcs = ["x.in"],
     outs = ["x.cc"],
     cmd = "$(locations :tool) $< >$@",
     tools = [":tool"],
)
cc_binary(
    name = "tool",
    srcs = ["tool.cpp"],
)

Genrules จะกำหนดค่าเครื่องมือในการกำหนดค่า exec ดังนั้นการค้นหาต่อไปนี้จะสร้างเอาต์พุตต่อไปนี้

การค้นหา สร้างเป้าหมายแล้ว เอาต์พุต
bazel cquery "//x:tool" //x:tool //x:tool(targetconfig)
bazel cquery "//x:tool" --universe_scope="//x:my_gen" //x:my_gen //x:tool(execconfig)

หากตั้งค่าแฟล็กนี้ ระบบจะสร้างเนื้อหาขึ้น หากไม่ได้ตั้งค่า ระบบจะสร้างเป้าหมายทั้งหมดที่กล่าวถึงในนิพจน์คำค้นหาแทน การปิดทางอ้อมของเป้าหมายที่สร้างขึ้นจะใช้เป็นจักรวาลของข้อความค้นหา ไม่ว่าจะเป็นลักษณะใดก็ตาม เป้าหมายที่จะสร้างต้องสร้างได้ที่ระดับบนสุด (ซึ่งเข้ากันได้กับตัวเลือกระดับบนสุด) cquery จะแสดงผลลัพธ์การปิดชั่วคราวของเป้าหมายระดับบนสุดเหล่านี้

แม้คุณจะสร้างเป้าหมายทั้งหมดในนิพจน์การค้นหาที่ระดับบนสุดได้ แต่ไม่ควรสร้างเป้าหมายทั้งหมด ตัวอย่างเช่น การตั้งค่า --universe_scope อย่างชัดเจนอาจป้องกันไม่ให้สร้างเป้าหมายหลายครั้งในการกำหนดค่าที่คุณไม่สนใจ นอกจากนี้ยังสามารถช่วยระบุเวอร์ชันการกำหนดค่าของเป้าหมายที่คุณต้องการได้ (เนื่องจากปัจจุบันยังไม่สามารถระบุรูปแบบการกำหนดค่านี้ได้อย่างสมบูรณ์) คุณควรตั้งค่าแฟล็กนี้หากนิพจน์คำค้นหาของคุณซับซ้อนกว่า deps(//foo)

--implicit_deps (บูลีน, default=True)

การตั้งค่าแฟล็กนี้เป็น "เท็จ" จะกรองผลลัพธ์ทั้งหมดที่ไม่ได้กำหนดไว้อย่างชัดเจนในไฟล์ BUILD และตั้งค่าที่อื่นโดย Bazel แทน ซึ่งรวมถึงการกรอง toolchain ที่แก้ไขแล้ว

--tool_deps (บูลีน, default=True)

การตั้งค่าแฟล็กนี้เป็น "เท็จ" จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งเส้นทางจากเป้าหมายที่ค้นหาไปยังเป้าหมายดังกล่าวมีการข้ามการเปลี่ยนระหว่างการกำหนดค่าเป้าหมายและการกำหนดค่าที่ไม่ใช่เป้าหมาย หากเป้าหมายที่ค้นหาอยู่ในการกำหนดค่าเป้าหมาย การตั้งค่า --notool_deps จะแสดงผลเฉพาะเป้าหมายที่อยู่ในการกำหนดค่าเป้าหมายด้วยเท่านั้น หากเป้าหมายที่ค้นหาอยู่ในการกำหนดค่าที่ไม่ใช่เป้าหมาย การตั้งค่า --notool_deps จะแสดงผลเฉพาะเป้าหมายในการกำหนดค่าที่ไม่ใช่เป้าหมายด้วย โดยทั่วไปการตั้งค่านี้จะไม่ส่งผลต่อการกรอง ชุดเครื่องมือที่แก้ไขแล้ว

--include_aspects (บูลีน, default=True)

รวมทรัพยากร Dependency ที่เพิ่มโดย Aspect

หากปิดใช้แฟล็กนี้ cquery somepath(X, Y) และ cquery deps(X) | grep 'Y' จะข้าม Y หาก X พิจารณาเฉพาะแง่มุมเท่านั้น

รูปแบบเอาต์พุต

โดยค่าเริ่มต้น เอาต์พุต cquery จะแสดงเป็นรายการคู่ป้ายกำกับและการกำหนดค่าที่เรียงลำดับตามทรัพยากร Dependency ยังมีตัวเลือกอื่นๆ ในการแสดงผลลัพธ์เช่นกัน

ทรานซิชัน

--transitions=lite
--transitions=full

การเปลี่ยนการกำหนดค่าใช้เพื่อสร้างเป้าหมายภายใต้เป้าหมายระดับบนสุดในการกำหนดค่าที่แตกต่างจากเป้าหมายระดับบนสุด

เช่น เป้าหมายอาจกำหนดการเปลี่ยนไปใช้การกำหนดค่าการดำเนินการบนทรัพยากร Dependency ทั้งหมดในแอตทริบิวต์ tools ซึ่งเรียกว่าการเปลี่ยน แอตทริบิวต์ กฎยังทำให้เกิดการเปลี่ยนการกำหนดค่าของตัวเอง หรือที่เรียกว่าการเปลี่ยนคลาสของกฎ รูปแบบเอาต์พุตนี้ให้ข้อมูลเกี่ยวกับการเปลี่ยนเหล่านี้ เช่น การเปลี่ยนประเภทและผลที่มีต่อตัวเลือกบิลด์

รูปแบบเอาต์พุตนี้จะทริกเกอร์โดยแฟล็ก --transitions ซึ่งตั้งค่าเริ่มต้นเป็น NONE ตัวเลือกนี้อาจตั้งค่าเป็นโหมด FULL หรือ LITE โหมด FULL ให้ข้อมูลเกี่ยวกับการเปลี่ยนคลาสของกฎและการเปลี่ยนแอตทริบิวต์ รวมถึงความแตกต่างโดยละเอียดของตัวเลือกก่อนและหลังการเปลี่ยน โหมด LITE จะแสดงผลข้อมูลเดียวกันโดยไม่มีความแตกต่างของตัวเลือก

เอาต์พุตข้อความโปรโตคอล

--output=proto

ตัวเลือกนี้จะทำให้ระบบพิมพ์เป้าหมายที่ได้ในรูปแบบบัฟเฟอร์โปรโตคอลไบนารี ดูคำจำกัดความของบัฟเฟอร์โปรโตคอลได้ที่ src/main/protobuf/analysis_v2.proto

CqueryResult คือข้อความระดับบนสุดที่มีผลลัพธ์ของการค้นหา ซึ่งมีรายการข้อความ ConfiguredTarget และรายชื่อข้อความ Configuration ข้อความ ConfiguredTarget แต่ละรายการจะมี configuration_id ที่มีค่าเท่ากับค่าของช่อง id จากข้อความ Configuration ที่เกี่ยวข้อง

--[no]proto:include_configurations

โดยค่าเริ่มต้น ผลลัพธ์ cquery จะแสดงข้อมูลการกำหนดค่าเป็นส่วนหนึ่งของเป้าหมายที่กำหนดค่าแต่ละรายการ หากคุณไม่ต้องการใช้ข้อมูลนี้และรับเอาต์พุต Proto ที่มีการจัดรูปแบบเหมือนกับเอาต์พุต Proto ของการค้นหา ให้ตั้งค่าแฟล็กนี้เป็น "เท็จ"

ดูเอกสารเกี่ยวกับเอาต์พุต Proto ของการค้นหาเพื่อดูตัวเลือกอื่นๆ ที่เกี่ยวข้องกับเอาต์พุตโปรโต

เอาต์พุตกราฟ

--output=graph

ตัวเลือกนี้จะสร้างเอาต์พุตเป็นไฟล์ .dot ที่ใช้ร่วมกับ Graphviz ได้ ดูรายละเอียดได้จากเอกสารประกอบเกี่ยวกับเอาต์พุตกราฟของ query cquery รวมถึง --graph:node_limit และ --graph:factored ด้วย

เอาต์พุตไฟล์

--output=files

ตัวเลือกนี้จะพิมพ์รายการไฟล์เอาต์พุตที่สร้างโดยเป้าหมายแต่ละรายการซึ่งตรงกับคำค้นหาที่คล้ายกับรายการที่พิมพ์ไว้ท้ายคำขอ bazel build ผลลัพธ์จะมีเฉพาะไฟล์ที่โฆษณาในกลุ่มเอาต์พุตที่ขอตามที่กำหนดโดยแฟล็ก --output_groups แต่รวมไฟล์ต้นฉบับ

เส้นทางทั้งหมดที่เกิดจากรูปแบบเอาต์พุตนี้จะสัมพัทธ์กับ execroot ซึ่งสามารถรับได้ผ่านทาง bazel info execution_root หากมีลิงก์สัญลักษณ์อำนวยความสะดวก bazel-out เส้นทางไปยังไฟล์ในที่เก็บหลักก็เปลี่ยนไปตามไดเรกทอรีพื้นที่ทำงานด้วย

การกำหนดรูปแบบเอาต์พุตโดยใช้ Starlark

--output=starlark

รูปแบบเอาต์พุตนี้จะเรียกใช้ฟังก์ชัน Starlark สำหรับเป้าหมายที่กำหนดค่าแต่ละรายการในผลการค้นหา และพิมพ์ค่าที่การเรียกกลับมา แฟล็ก --starlark:file ระบุตำแหน่งของไฟล์ Starlark ที่กำหนดฟังก์ชันที่ชื่อว่า format ที่มีพารามิเตอร์เดียว นั่นคือ target โดยฟังก์ชันนี้จะเรียกฟังก์ชันนี้สำหรับเป้าหมายแต่ละรายการในผลการค้นหา หรือคุณจะระบุเฉพาะเนื้อหาของฟังก์ชันที่ประกาศเป็น def format(target): return expr โดยใช้แฟล็ก --starlark:expr ก็ได้เพื่อความสะดวก

ภาษาถิ่น "cquery" แบบ Starlark

สภาพแวดล้อมการค้นหา Starlark แตกต่างจากไฟล์ BUILD หรือ .bzl ซึ่งรวมถึงค่าคงที่และฟังก์ชันในตัวของ Starlark หลักทั้งหมด รวมถึงฟังก์ชันเฉพาะคำค้นหาบางรายการที่อธิบายไว้ด้านล่าง แต่ไม่ใช่ (ตัวอย่างเช่น) glob, native หรือ rule และไม่รองรับคำสั่งการโหลด

build_options(target)

build_options(target) แสดงผลแผนที่ซึ่งมีคีย์เป็นตัวระบุตัวเลือกบิลด์ (ดูการกำหนดค่า) และมีค่าต่างๆ ที่เป็นค่า Starlark ตัวเลือกบิลด์ที่มีค่าที่ไม่ใช่ค่า Starlark ตามกฎหมายจะไม่รวมอยู่ในแผนที่นี้

หากเป้าหมายเป็นไฟล์อินพุต build_options(target) จะแสดงผลเป็น "ไม่มี" เนื่องจากเป้าหมายไฟล์อินพุตมีการกำหนดค่า Null

ผู้ให้บริการ(เป้าหมาย)

providers(target) แสดงผลแผนที่ซึ่งมีคีย์ที่เป็นชื่อของผู้ให้บริการ (เช่น "DefaultInfo") และมีค่าเป็น Starlark ผู้ให้บริการที่มีค่าที่ไม่ใช่ค่า Starlark ตามกฎหมายจะไม่รวมอยู่ในแผนที่นี้

ตัวอย่าง

พิมพ์รายการชื่อพื้นฐานของไฟล์ทั้งหมดที่สร้างโดย //foo โดยคั่นด้วยการเว้นวรรค:

  bazel cquery //foo --output=starlark \
    --starlark:expr="' '.join([f.basename for f in target.files.to_list()])"

พิมพ์รายการเส้นทางของไฟล์ทั้งหมดที่สร้างขึ้นโดยเป้าหมายกฎใน //bar และแพ็กเกจย่อย โดยคั่นด้วยช่องว่าง

  bazel cquery 'kind(rule, //bar/...)' --output=starlark \
    --starlark:expr="' '.join([f.path for f in target.files.to_list()])"

พิมพ์รายการการช่วยจำของการดำเนินการทั้งหมดที่ลงทะเบียนโดย //foo

  bazel cquery //foo --output=starlark \
    --starlark:expr="[a.mnemonic for a in target.actions]"

พิมพ์รายการเอาต์พุตการคอมไพล์ที่บันทึกโดย cc_library //baz

  bazel cquery //baz --output=starlark \
    --starlark:expr="[f.path for f in target.output_groups.compilation_outputs.to_list()]"

พิมพ์ค่าของตัวเลือกบรรทัดคำสั่ง --javacopt เมื่อสร้าง //foo

  bazel cquery //foo --output=starlark \
    --starlark:expr="build_options(target)['//command_line_option:javacopt']"

พิมพ์ป้ายกำกับของแต่ละเป้าหมายที่มีเอาต์พุตเพียงรายการเดียว ตัวอย่างนี้ใช้ฟังก์ชัน Starlark ที่กำหนดไว้ในไฟล์

  $ cat example.cquery

  def has_one_output(target):
    return len(target.files.to_list()) == 1

  def format(target):
    if has_one_output(target):
      return target.label
    else:
      return ""

  $ bazel cquery //baz --output=starlark --starlark:file=example.cquery

พิมพ์ป้ายกำกับของแต่ละเป้าหมายที่เป็น Python 3 โดยเฉพาะ ตัวอย่างนี้ใช้ฟังก์ชัน Starlark ที่กำหนดไว้ในไฟล์

  $ cat example.cquery

  def format(target):
    p = providers(target)
    py_info = p.get("PyInfo")
    if py_info and py_info.has_py3_only_sources:
      return target.label
    else:
      return ""

  $ bazel cquery //baz --output=starlark --starlark:file=example.cquery

ดึงค่าจากผู้ให้บริการที่ผู้ใช้กำหนด

  $ cat some_package/my_rule.bzl

  MyRuleInfo = provider(fields={"color": "the name of a color"})

  def _my_rule_impl(ctx):
      ...
      return [MyRuleInfo(color="red")]

  my_rule = rule(
      implementation = _my_rule_impl,
      attrs = {...},
  )

  $ cat example.cquery

  def format(target):
    p = providers(target)
    my_rule_info = p.get("//some_package:my_rule.bzl%MyRuleInfo'")
    if my_rule_info:
      return my_rule_info.color
    return ""

  $ bazel cquery //baz --output=starlark --starlark:file=example.cquery

cquery กับ query

cquery และ query ส่งเสริมซึ่งกันและกัน และเก่งในเรื่องเฉพาะกลุ่มที่แตกต่างกัน ลองพิจารณาสิ่งต่อไปนี้เพื่อตัดสินใจเลือกเครื่องมือที่เหมาะกับคุณ

  • cquery จะตามกิ่งไม้ select() ที่เฉพาะเจาะจงเพื่อสร้างรูปแบบกราฟที่ถูกต้องที่คุณสร้างขึ้น query ไม่ทราบว่าบิลด์เลือกสาขาใด ให้รวม Branch ทั้งหมดโดยประมาณให้มากเกินไป
  • ความแม่นยำของ cquery ต้องการการสร้างกราฟมากกว่า query โดยเฉพาะอย่างยิ่ง cquery จะประเมินเป้าหมายที่กำหนดค่าไว้ ขณะที่ query ประเมินเฉพาะเป้าหมาย ซึ่งจะใช้เวลานานขึ้นและใช้หน่วยความจำมากขึ้น
  • การตีความภาษาของการค้นหาของ cquery ก่อให้เกิดความกำกวมที่ query หลีกเลี่ยง เช่น หากมี "//foo" อยู่ในการกำหนดค่า 2 รายการ cquery "deps(//foo)"ควรใช้การกำหนดค่าใด ฟังก์ชัน config สามารถช่วยในเรื่องนี้ได้
  • ในฐานะเครื่องมือที่ใหม่กว่า cquery จึงไม่รองรับกรณีการใช้งานบางอย่าง โปรดดูรายละเอียดในปัญหาที่ทราบ

ปัญหาที่ทราบแล้ว

เป้าหมายทั้งหมดที่ cquery "สร้าง" ต้องมีการกำหนดค่าเดียวกัน

ก่อนประเมินคำค้นหา cquery จะทริกเกอร์บิลด์ก่อนจุดที่จะมีการดำเนินการบิลด์ ระบบจะเลือกเป้าหมายที่ "สร้าง" เป็นค่าเริ่มต้นจากป้ายกำกับทั้งหมดที่ปรากฏในนิพจน์การค้นหา (ลบล้างด้วย --universe_scope ได้) โดยเป้าหมายเหล่านี้ต้องมีการกำหนดค่าเดียวกัน

แม้ว่าโดยทั่วไปแล้ว กรณีเหล่านี้จะใช้การกำหนดค่า "เป้าหมาย" ระดับบนสุด แต่กฎจะเปลี่ยนการกำหนดค่าของตนเองได้ด้วยการเปลี่ยนผ่านขอบขาเข้า นี่คือสาเหตุที่ cquery ย่อ

วิธีแก้ปัญหาเบื้องต้น: หากเป็นไปได้ ให้ตั้งค่า --universe_scope เป็นขอบเขตที่เข้มงวดมากขึ้น เช่น

# This command attempts to build the transitive closures of both //foo and
# //bar. //bar uses an incoming edge transition to change its --cpu flag.
$ bazel cquery 'somepath(//foo, //bar)'
ERROR: Error doing post analysis query: Top-level targets //foo and //bar
have different configurations (top-level targets with different
configurations is not supported)

# This command only builds the transitive closure of //foo, under which
# //bar should exist in the correct configuration.
$ bazel cquery 'somepath(//foo, //bar)' --universe_scope=//foo

ไม่รองรับ --output=xml

เอาต์พุตแบบไม่กําหนด

cquery ไม่ล้างกราฟบิลด์จากคำสั่งก่อนหน้าโดยอัตโนมัติ ดังนั้นจึงมีแนวโน้มที่จะรวบรวมผลลัพธ์จากการค้นหาที่ผ่านมา เช่น genrule ดำเนินการเปลี่ยนผู้บริหารในแอตทริบิวต์ tools กล่าวคือ กำหนดค่าเครื่องมือในการกำหนดค่าไฟล์ดำเนินการ

ดูผลกระทบของการเปลี่ยนดังกล่าวได้ที่ด้านล่าง

$ cat > foo/BUILD <<<EOF
genrule(
    name = "my_gen",
    srcs = ["x.in"],
    outs = ["x.cc"],
    cmd = "$(locations :tool) $< >$@",
    tools = [":tool"],
)
cc_library(
    name = "tool",
)
EOF

    $ bazel cquery "//foo:tool"
tool(target_config)

    $ bazel cquery "deps(//foo:my_gen)"
my_gen (target_config)
tool (exec_config)
...

    $ bazel cquery "//foo:tool"
tool(exec_config)

วิธีแก้ปัญหาเบื้องต้นคือ เปลี่ยนตัวเลือกการเริ่มต้นใช้งานเพื่อบังคับให้มีการวิเคราะห์เป้าหมายที่กำหนดค่าไว้อีกครั้ง ตัวอย่างเช่น เพิ่ม --test_arg=<whatever> ลงในคำสั่งบิลด์

การแก้ปัญหา

รูปแบบเป้าหมายที่เกิดซ้ำ (/...)

หากพบปัญหาต่อไปนี้

$ bazel cquery --universe_scope=//foo:app "somepath(//foo:app, //foo/...)"
ERROR: Error doing post analysis query: Evaluation failed: Unable to load package '[foo]'
because package is not in scope. Check that all target patterns in query expression are within the
--universe_scope of this query.

ข้อผิดพลาดนี้แนะนำว่าแพ็กเกจ //foo ไม่อยู่ในขอบเขตนี้ แม้ว่า --universe_scope=//foo:app จะรวมแพ็กเกจดังกล่าวไว้ด้วยก็ตาม ซึ่งเกิดจากข้อจำกัดในการออกแบบใน cquery ในการแก้ไขเบื้องต้น ให้ใส่ //foo/... ไว้ในขอบเขตจักรวาลให้ชัดเจน ดังนี้

$ bazel cquery --universe_scope=//foo:app,//foo/... "somepath(//foo:app, //foo/...)"

หากไม่ได้ผล (เช่น เนื่องจากเป้าหมายบางรายการใน //foo/... ไม่สามารถสร้างด้วยแฟล็กบิลด์ที่เลือก) ให้แยกรูปแบบลงในแพ็กเกจส่วนประกอบด้วยคำค้นหาที่ประมวลผลล่วงหน้าด้วยตนเอง ดังนี้

# Replace "//foo/..." with a subshell query call (not cquery!) outputting each package, piped into
# a sed call converting "<pkg>" to "//<pkg>:*", piped into a "+"-delimited line merge.
# Output looks like "//foo:*+//foo/bar:*+//foo/baz".
#
$  bazel cquery --universe_scope=//foo:app "somepath(//foo:app, $(bazel query //foo/...
--output=package | sed -e 's/^/\/\//' -e 's/$/:*/' | paste -sd "+" -))"