검색 쿼리 참조

Updated: June 11, 2026

이 문서는 Workspace 하드웨어 설계 검색 언어에서 사용되는 구문, 연산자, 규칙에 대한 참조 가이드입니다. 검색 쿼리는 익숙한 field:value 구문을 기반으로 하며, 빠르고 단순한 검색부터 강력하고 정밀한 쿼리 작성까지 사용할 수 있습니다.

검색 구문 및 가이드

아래 참조 정보는 검색 대상 유형(컴포넌트, 연결 등)별로 구성되어 있으며, 각 섹션에는 사용 카테고리 하위 유형, 사용 예시, 해당 예제 쿼리가 포함되어 있습니다.

컴포넌트 검색

Use Category	Application Example	Query
Basics	Designator로 알려진 컴포넌트를 찾습니다.	`R14`
	Designator로 특정 IC 컴포넌트를 찾습니다.	`designator:U7`
	이름/주석으로 컴포넌트를 찾습니다(예: ERJ-2RKF1002X 또는 "Capacitor 100nF +/-20% 50V 0402"]).	`comment:ERJ-2RKF1002X`
	Value 파라미터로 컴포넌트를 찾습니다(예: 100nF 또는 4.7k).	`value:100nF`
	특정 물리 패키지의 컴포넌트를 찾습니다(예: QFN-48).	`package:0402`
	특정 PCB 풋프린트 이름을 사용하는 컴포넌트를 찾습니다.	`footprint:RESC0402`
Identifiers	표면실장소자(SMD)인 컴포넌트를 찾습니다.	`mounting:smd`
Identifiers	모든 스루홀 기술(THT) 컴포넌트를 찾습니다.	`mounting:tht`
Types	모든 수동소자 컴포넌트(저항, 커패시터, 인덕터)를 찾습니다.	`type:passive`
	모든 능동소자 컴포넌트(IC, 트랜지스터, 다이오드)를 찾습니다.	`type:active`
	커넥터로 분류된 모든 컴포넌트를 찾습니다.	`type:connector`
Connections	특정 핀 이름 또는 번호를 포함하는 컴포넌트를 찾습니다.	`pin:SCLK`
Connections	지정된 방향(예: input, output, IO 등)의 핀을 포함하는 컴포넌트를 찾습니다. 지정된 방향의 Port도 함께 찾습니다.	`direction:output`
Parametric	특정 속성 또는 파라미터(예: Tolerance)를 가지며 값은 상관없는 컴포넌트를 찾습니다.	`has:tolerance`
	파라미터가 특정 값을 가지는 컴포넌트를 찾습니다	`tolerance:1%`
	숫자형 파라미터가 특정 범위에 있는 컴포넌트를 찾습니다. 필터. 공백이 포함된 파라미터 이름은 따옴표로 묶어야 합니다.	`"Voltage Rating":[3V to 5.5V]`
	특정 전력 정격 파라미터를 가지는 Top 레이어의 컴포넌트를 찾습니다. 필터	`power:63mW layer:Top`

넷 검색

Use Category	Application Example	Query
Basics	이름으로 알려진 넷을 찾습니다.	`GND`
Basics	이름으로 특정 전원 넷을 찾습니다(예: VCC, GND, VSENSE).	`net:VCC3`
Classes	넷 클래스에 속하는 모든 넷을 찾습니다.	`netclass:analog`
	특정 차동 페어의 넷을 찾습니다.	`diffpair:USB_SYS`
	차동 페어 클래스의 모든 넷 쌍을 찾습니다.	`diffpairclass:USB`

연결성

Use Category	Application Example	Query
Simple Search	컴포넌트 U3와 여기에 연결된 모든 것을 찾습니다. 능동소자 사이의 수동소자(예: 종단 저항, 커플링 커패시터)를 우회한 논리적 연결 경로도 함께 표시됩니다.	`connectsTo:U3`
Simple Search	넷 'SYS_CLK'와 여기에 연결된 모든 것을 찾습니다.	`connectsTo:SYS_CLK`
Advanced Search	컴포넌트 U3와 여기에 직접 연결된 모든 것을 찾습니다. 물리적(동일 넷) 연결만 표시되며, 능동소자 간의 논리적 연결은 포함되지 않습니다.	`connectsTo.Direct:U3`
	컴포넌트 U3와 그에 대한 물리적 및 논리적 연결을 모두 찾되, 전원 레일로의 연결은 제외합니다.	`connectsTo.noPower:U3`
	컴포넌트 U3와 그에 대한 물리적(동일 넷) 연결을 찾되, 전원 레일로의 연결은 제외합니다.	`ConnectsTo.Direct:U3 ConnectsTo.NoPower:U3`
	컴포넌트 U12의 5번 핀에 연결된 특정 넷을 찾습니다.	`connectsTo:U12.5`
	컴포넌트 U12의 'D_CLK' 입력에 연결된 특정 넷을 찾습니다.	`connectsTo:U12.D_CLK`
	특정 PCB 레이어(예: L3 및 Bottom)의 CAN 버스 넷을 찾습니다. 필터	`net:can* layer:Bottom layer:L3`

설계 객체

Use Category	Application Example	Query
General Types	특정 유형의 객체를 찾습니다 [예: pad, via, track].	`object:pad`
General Types	특정 넷에 있는 특정 객체를 찾습니다(예: 그라운드 넷의 비아). 필터	`object:via net:GND`
Advanced	PCB 내부 레이어의 트랙(배선)을 찾습니다. (즉, Top 또는 Bottom 레이어는 제외). 필터	`object:track -layer:Top -layer:Bottom`
	출력으로 지정된 모든 핀을 찾습니다. 필터	`direction:output object:pin`
	직사각형 형상 유형의 모든 패드를 찾습니다. 필터	`object:pad shape:rectangle`

논리 및 범위 필터

Use Category	Application Example	Query
Wildcards	'VCC' 뒤에 여러 문자가 포함된 이름의 모든 넷을 찾습니다(예: VCC1, VCC_Digital, VCC_Analog).	`net:VCC*`
Wildcards	Designator에 'C1' 뒤에 단일 문자가 포함된 모든 컴포넌트를 찾습니다(즉, 커패시터 C11 ~ C19)	`C1?`
Logic Combinations	Top 레이어의 커패시터를 찾습니다. 검색식 사이의 공백은 암시적 AND임에 유의하십시오.	`type:Capacitor AND layer:Top`
	0402 또는 0603 패키지 중 하나를 사용하는 컴포넌트를 찾습니다. OR 논리식은 AND 논리와 함께 사용할 때 괄호로 묶어야 합니다.	`package:0402 OR package:0603`
	U1에 대한 모든 연결을 표시하되, GND 레이어로의 연결은 포함하지 않습니다. '-' 문자는 'NOT' 논리 한정자(-term:value)와 동일합니다.	`connectsto:U1 NOT Layer:GND`
Parentheses Logic	0402 또는 0603 패키지 중 하나를 사용하는 컴포넌트를 찾습니다.	`package:(0402 OR 0603)`
Parentheses Logic	PCB 내부 레이어의 트랙(배선)을 찾습니다. (즉, Top 또는 Bottom 레이어는 제외).	`object:track -layer:(Top or Bottom)`
Ranges	지정된 길이보다 긴 PCB 트랙을 찾습니다. '>' 문자는 항목의 콜론을 대체합니다.	`object:Track tracklength>100mm`
	홀 크기가 지정된 직경보다 크거나 같은 PCB 패드를 찾습니다.	`object:Pad holesize>=0.6mm`
	지정된 범위의 값을 가지는 저항을 찾습니다. 대괄호 사용에 유의하십시오.	`R* Value:[100k to 200k]`
	길이가 1mm에서 1.5mm 사이인 PCB 넷을 찾습니다. 연결(pad, via, pin 등)도 포함됩니다.	`NetLength:[1mm to 1.5mm]`

계층 및 그룹화 검색

Use Category	Application Example	Query
Logical Groups	'DecouplingCaps' 컴포넌트 클래스의 모든 컴포넌트를 찾습니다.	`componentClass:DecouplingCaps`
Logical Groups	'DDR_DATA' 넷 클래스에 속하는 모든 넷을 찾습니다.	`netClass:DDR_DATA`
Physical Groups	지정된 PCB 레이어(예: Mid 3)의 모든 엔티티를 찾습니다.	`layer:"Mid 3"`
Physical Groups	PCB의 'RF_Shield' room 안에 있는 모든 컴포넌트를 찾습니다.	`room:RF_Shield`

물리 설계

Use Category	Application Example	Query
Physical Properties	트레이스 길이가 50mm보다 긴 고속 넷을 찾습니다. 필터	`netClass:HighSpeed netlength>50mm`
	폭이 10 mil보다 큰 보드 트레이스(트랙)를 표시합니다. 필터	`object:track trackwidth>10mil`
	드릴 홀 크기가 8 mil보다 작은 비아를 찾습니다. 필터	`object:via holesize<8mil`

문서 검색

Use Category	Application Example	Query
Document Objects	설계 PCB 문서(예: 'Module1')의 모든 객체를 찾습니다.	`document:module1.pcbdoc`
	'Power' 회로도 문서의 모든 객체를 찾습니다.	`sheet:power.schdoc`
	지정된 회로도의 저항을 찾습니다. 필터	`sheet:power.schdoc type:resistor`

라이브러리 관리

Use Category	Application Example	Query
Status	PCB 풋프린트는 있지만 3D 모델은 없는 모든 컴포넌트를 찾습니다. 필터	`has:footprint -has:model3d`
Status	시뮬레이션 모델이 없는 모든 컴포넌트를 찾습니다.	`-has:simulation_model`
Parts Source	특정 라이브러리 소스(예: Workspace, Internal parts stock, project.IntLib)에서 사용된 컴포넌트를 찾습니다.	`Library_Path:”Company Stock”.`

프린터 출력용 버전

AI로 번역됨

만약 문제가 있으시다면, 텍스트/이미지를 선택하신 상태에서 Ctrl + Enter를 누르셔서 저희에게 피드백을 보내주세요.

기능 제공 여부

사용 가능한 기능은 보유하고 계시는 Altium 솔루션에 따라 달라집니다. 해당 솔루션은 Altium Develop, Altium Agile의 에디션(Agile Teams 또는 Agile Enterprise), 또는 활성기간 내의 Altium Designer 중 하나입니다.

안내된 기능이 고객님의 소프트웨어에서 보이지 않는 경우, 보다 자세한 내용을 위해 Altium 영업팀 에 문의해 주세요.