outerjoin

테이블 또는 타임테이블 두 개 간 외부 조인

구문

T = outerjoin(Tleft,Tright)

T = outerjoin(Tleft,Tright,Name,Value)

[T,ileft,iright] = outerjoin(___)

설명

T = outerjoin(Tleft,Tright)는 키 변수를 사용하여 Tleft와 Tright의 외부 조인인 테이블 또는 타임테이블 T를 만듭니다. 외부 조인은 키 변수가 일치하는 값을 갖는 테이블 행을 결합하지만, 한 입력 테이블의 어떤 키 변수와도 일치하지 않는 다른 입력 테이블의 키 변수가 있는 행도 포함합니다. 예를 들어, Tleft가 Key1, Var1이라는 이름의 변수를 갖고 Tright가 Key1, Var2라는 변수를 갖는 경우 T=outerjoin(Tleft,Tright)는 Key1을 키 변수로 사용합니다.

기본적으로 키 변수는 다음과 같습니다.

• 두 입력값이 모두 테이블이거나 Tleft가 타임테이블이고 Tright가 테이블인 경우 Tleft와 Tright에서 동일한 이름을 갖는 변수.

• Tleft와 Tright가 둘 다 타임테이블인 경우 행 시간값으로 구성된 벡터.

왼쪽 테이블과 오른쪽 테이블에서 키 변수의 일치하는 값은 순서가 동일하지 않아도 됩니다. 외부 조인은 두 테이블의 키 변수 간에 일대다 일치와 다대일 일치를 수행할 수 있습니다. 즉, 왼쪽 테이블의 키 변수에 한 번 나타나는 값이 오른쪽 테이블에서 여러 일치 항목을 가질 수 있습니다. 마찬가지로, 오른쪽 테이블의 키 변수에 한 번 나타나는 값이 왼쪽 테이블에서 여러 일치 항목을 가질 수 있습니다.

외부 조인은 테이블 및 타임테이블의 특정한 조합에서 수행할 수 있습니다.

• Tleft가 테이블이면 Tright도 테이블이어야 합니다. outerjoin은 T를 테이블로 반환합니다.

• Tleft가 타임테이블이면 Tright는 테이블이거나 타임테이블일 수 있습니다. outerjoin은 입력값들의 두 가지 조합 어느 쪽에 대해서도 T를 타임테이블로 반환합니다.

T = outerjoin(Tleft,Tright,Name,Value)는 하나 이상의 Name,Value 쌍 인수로 지정된 추가 옵션을 통해 외부 조인 연산을 수행합니다.

[T,ileft,iright] = outerjoin(___)은 T의 행과 Tleft 및 Tright 각각의 행 사이의 대응 관계를 나타내는 인덱스 벡터 ileft와 iright 역시 반환합니다. 이 구문은 위에 열거된 구문의 입력 인수와 함께 사용할 수 있습니다.

예제

공통 변수가 하나인 테이블 간의 외부 조인 연산하기

테이블 Tleft를 만듭니다.

Tleft = table([5;12;23;2;15;6],...
        {'cheerios';'pizza';'salmon';'oreos';'lobster';'pizza'},...
        'VariableNames',{'Age','FavoriteFood'},...
        'RowNames',{'Amy','Bobby','Holly','Harry','Marty','Sally'})

Tleft=6×2 table
             Age    FavoriteFood
             ___    ____________

    Amy       5     {'cheerios'}
    Bobby    12     {'pizza'   }
    Holly    23     {'salmon'  }
    Harry     2     {'oreos'   }
    Marty    15     {'lobster' }
    Sally     6     {'pizza'   }

Tleft와 하나의 공통 변수 FavoriteFood를 가지고 있는 테이블 Tright를 생성합니다.

Tright = table({'cheerios';'oreos';'pizza';'salmon';'cake'},...
         [110;160;140;367;243],...
         {'A-';'D';'B';'B';'C-'},...
         'VariableNames',{'FavoriteFood','Calories','NutritionGrade'})

Tright=5×3 table
    FavoriteFood    Calories    NutritionGrade
    ____________    ________    ______________

    {'cheerios'}      110           {'A-'}    
    {'oreos'   }      160           {'D' }    
    {'pizza'   }      140           {'B' }    
    {'salmon'  }      367           {'B' }    
    {'cake'    }      243           {'C-'}    

outerjoin 함수를 사용하여 테이블 Tleft와 Tright의 데이터로 새 테이블 T를 생성합니다.

T = outerjoin(Tleft,Tright)

T=7×5 table
    Age    FavoriteFood_Tleft    FavoriteFood_Tright    Calories    NutritionGrade
    ___    __________________    ___________________    ________    ______________

    NaN       {0×0 char  }          {'cake'    }          243         {'C-'    }  
      5       {'cheerios'}          {'cheerios'}          110         {'A-'    }  
     15       {'lobster' }          {0×0 char  }          NaN         {0×0 char}  
      2       {'oreos'   }          {'oreos'   }          160         {'D'     }  
     12       {'pizza'   }          {'pizza'   }          140         {'B'     }  
      6       {'pizza'   }          {'pizza'   }          140         {'B'     }  
     23       {'salmon'  }          {'salmon'  }          367         {'B'     }  

테이블 T에는 Tleft의 키 변수에 대한 개별 변수(FavoriteFood_Tleft)와 Tright의 키 변수에 대한 개별 변수(FavoriteFood_Tright)가 포함됩니다.

키 변수 쌍을 단일 변수로 병합하기

테이블 Tleft를 만듭니다.

Tleft = table({'a' 'b' 'c' 'e' 'h'}',[1 2 3 11 17]',...
        'VariableNames',{'Key1' 'Var1'})

Tleft=5×2 table
    Key1     Var1
    _____    ____

    {'a'}      1 
    {'b'}      2 
    {'c'}      3 
    {'e'}     11 
    {'h'}     17 

테이블 Tleft와 Tright 간의 공통된 값을 변수 Key1에 포함할 뿐만 아니라, Tleft에 없는 값도 Key1 값으로 포함하는 행을 갖는 테이블 Tright를 생성합니다.

Tright = table({'a','b','d','e'}',[4;5;6;7],...
         'VariableNames',{'Key1' 'Var2'})

Tright=4×2 table
    Key1     Var2
    _____    ____

    {'a'}     4  
    {'b'}     5  
    {'d'}     6  
    {'e'}     7  

outerjoin 함수를 사용하여 테이블 Tleft와 Tright의 데이터로 새 테이블 T를 생성합니다. 키 값을 출력 테이블 T의 단일 변수로 병합합니다.

T = outerjoin(Tleft,Tright,'MergeKeys',true)

T=6×3 table
    Key1     Var1    Var2
    _____    ____    ____

    {'a'}      1       4 
    {'b'}      2       5 
    {'c'}      3     NaN 
    {'d'}    NaN       6 
    {'e'}     11       7 
    {'h'}     17     NaN 

테이블 T의 변수 중 Tleft에서 온 변수는 Tright와 일치하는 항목이 없는 행에 누락값을 포함합니다. 마찬가지로, T의 변수 중 Tright에서 온 변수는 Tleft와 일치하는 항목이 없는 행에 누락값을 포함합니다.

테이블 간 외부 조인 연산과 값에 대한 인덱스

테이블 Tleft를 만듭니다.

Tleft = table({'a' 'b' 'c' 'e' 'h'}',[1 2 3 11 17]',...
        'VariableNames',{'Key1' 'Var1'})

Tleft=5×2 table
    Key1     Var1
    _____    ____

    {'a'}      1 
    {'b'}      2 
    {'c'}      3 
    {'e'}     11 
    {'h'}     17 

테이블 Tleft와 Tright 간의 공통된 값을 변수 Key1에 포함할 뿐만 아니라, Tleft에 없는 값도 Key1 값으로 포함하는 행을 갖는 테이블 Tright를 생성합니다.

Tright = table({'a','b','d','e'}',[4;5;6;7],...
         'VariableNames',{'Key1' 'Var2'})

Tright=4×2 table
    Key1     Var2
    _____    ____

    {'a'}     4  
    {'b'}     5  
    {'d'}     6  
    {'e'}     7  

outerjoin 함수를 사용하여 테이블 Tleft와 Tright의 데이터로 새 테이블 T를 생성합니다. 키 변수 Key1에서 공통 값을 가지는 행은 대응시키고, 키 값이 일치하지 않는 행은 그대로 유지합니다.

T의 행과 Tleft 및 Tright 각각의 행 사이의 대응 관계를 나타내는 인덱스 벡터 ileft와 iright 역시 반환합니다.

[T,ileft,iright] = outerjoin(Tleft,Tright)

T=6×4 table
    Key1_Tleft    Var1    Key1_Tright    Var2
    __________    ____    ___________    ____

    {'a'     }      1     {'a'     }       4 
    {'b'     }      2     {'b'     }       5 
    {'c'     }      3     {0×0 char}     NaN 
    {0×0 char}    NaN     {'d'     }       6 
    {'e'     }     11     {'e'     }       7 
    {'h'     }     17     {0×0 char}     NaN 

ileft = 6×1

     1
     2
     3
     0
     4
     5

iright = 6×1

     1
     2
     0
     3
     4
     0

인덱스 벡터 ileft와 iright에 포함된 0은 테이블 Tleft 또는 Tright의 행에 각각 대응하지 않는 테이블 T의 행을 나타냅니다.

테이블 간 왼쪽 외부 조인 연산과 값에 대한 인덱스

테이블 Tleft를 만듭니다.

Tleft = table({'a' 'b' 'c' 'e' 'h'}',[1 2 3 11 17]',...
        'VariableNames',{'Key1' 'Var1'})

Tleft=5×2 table
    Key1     Var1
    _____    ____

    {'a'}      1 
    {'b'}      2 
    {'c'}      3 
    {'e'}     11 
    {'h'}     17 

테이블 Tleft와 Tright 간의 공통된 값을 변수 Key1에 포함할 뿐만 아니라, Tleft에 없는 값도 Key1 값으로 포함하는 행을 갖는 테이블 Tright를 생성합니다.

Tright = table({'a','b','d','e'}',[4;5;6;7],...
         'VariableNames',{'Key1' 'Var2'})

Tright=4×2 table
    Key1     Var2
    _____    ____

    {'a'}     4  
    {'b'}     5  
    {'d'}     6  
    {'e'}     7  

outerjoin 함수를 사용하여 테이블 Tleft와 Tright의 데이터로 새 테이블 T를 생성합니다. Tright에서 키 값이 Tleft의 행과 일치하지 않는 행은 무시합니다.

T의 행과 Tleft 및 Tright 각각의 행 사이의 대응 관계를 나타내는 인덱스 벡터 ileft와 iright 역시 반환합니다.

[T,ileft,iright] = outerjoin(Tleft,Tright,'Type','left')

T=5×4 table
    Key1_Tleft    Var1    Key1_Tright    Var2
    __________    ____    ___________    ____

      {'a'}         1     {'a'     }       4 
      {'b'}         2     {'b'     }       5 
      {'c'}         3     {0×0 char}     NaN 
      {'e'}        11     {'e'     }       7 
      {'h'}        17     {0×0 char}     NaN 

ileft = 5×1

     1
     2
     3
     4
     5

iright = 5×1

     1
     2
     0
     4
     0

ileft의 어떤 값도 0이 아니며, 이는 T의 모든 행이 Tleft의 행과 대응 관계에 있음을 나타냅니다.

타임테이블의 외부 조인 연산하기

두 개의 타임테이블 Tleft와 Tright를 생성합니다. 이 두 타임테이블은 몇 개의 공통 행 시간값을 가지고, 서로의 타임테이블에 없는 행 시간값도 포함합니다.

Tleft = timetable(seconds([1;2;4;6]),[1 2 3 11]')

Tleft=4×1 timetable
    Time     Var1
    _____    ____

    1 sec      1 
    2 sec      2 
    4 sec      3 
    6 sec     11 

Tright = timetable(seconds([2;4;6;7]),[4 5 6 7]')

Tright=4×1 timetable
    Time     Var1
    _____    ____

    2 sec     4  
    4 sec     5  
    6 sec     6  
    7 sec     7  

Tleft와 Tright를 외부 조인으로 결합시킵니다. T1은 행을 공통 행 시간값과 대응시키고, 일치 항목이 없는 행도 포함합니다.

T1 = outerjoin(Tleft,Tright)

T1=5×2 timetable
    Time     Var1_Tleft    Var1_Tright
    _____    __________    ___________

    1 sec         1            NaN    
    2 sec         2              4    
    4 sec         3              5    
    6 sec        11              6    
    7 sec       NaN              7    

Tleft와 Tright를 결합시키지만, 행 시간값이 Tleft의 행 시간값과 일치하지 않는 Tright의 행은 무시합니다.

T2 = outerjoin(Tleft,Tright,'Type','left')

T2=4×2 timetable
    Time     Var1_Tleft    Var1_Tright
    _____    __________    ___________

    1 sec         1            NaN    
    2 sec         2              4    
    4 sec         3              5    
    6 sec        11              6    

입력 인수

Tleft — 왼쪽 테이블

테이블 | 타임테이블

왼쪽 테이블로, table형이나 timetable형으로 지정됩니다.

Tright — 오른쪽 테이블

테이블 | 타임테이블

오른쪽 테이블로, table형이나 timetable형으로 지정됩니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: 'Keys',2는 Tleft의 두 번째 변수와 Tright의 두 번째 변수를 키 변수로 사용합니다.

Keys — 키로 사용할 변수

양의 정수 | 양의 정수로 구성된 벡터 | string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | pattern형 스칼라 | 논리형 벡터

키로 사용할 변수로, 'Keys'와 함께 양의 정수, 양의 정수로 구성된 벡터, string형 배열, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, pattern형 스칼라 또는 논리형 벡터가 쉼표로 구분되어 지정됩니다.

'Keys' 이름-값 쌍의 인수는 'LeftKeys' 및 'RightKeys' 이름-값 쌍의 인수와 함께 사용할 수 없습니다.

행 레이블로 구성된 벡터는 키가 될 수 있습니다. 자세한 내용은 알고리즘 섹션을 참조하십시오.

예: 'Keys',[1 3]은 Tleft와 Tright의 첫 번째와 세 번째 변수를 키 변수로 사용합니다.

예: 'Keys',{'X','Y'}는 Tleft와 Tright에 포함된 X라는 이름의 변수와 Y라는 이름의 변수를 키 변수로 사용합니다.

예: 'Keys','Row'는 Tleft와 Tright가 모두 행 이름이 있는 테이블이면 Tleft와 Tright의 행 이름으로 구성된 벡터를 키 변수로 사용합니다.

LeftKeys — Tleft에서 키로 사용할 변수

양의 정수 | 양의 정수로 구성된 벡터 | string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | pattern형 스칼라 | 논리형 벡터

Tleft에서 키로 사용할 변수로, 'LeftKeys'와 함께 양의 정수, 양의 정수로 구성된 벡터, string형 배열, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, pattern형 스칼라 또는 논리형 벡터가 쉼표로 구분되어 지정됩니다.

'LeftKeys' 이름-값 쌍의 인수는 'RightKeys' 이름-값 쌍의 인수와 함께 사용해야 합니다. 'LeftKeys'와 'RightKeys'는 모두 동일한 수의 키 변수를 지정해야 합니다. outerjoin은 키 값의 순서에 기초하여 키 값의 쌍을 지정합니다.

행 레이블로 구성된 벡터는 키가 될 수 있습니다. 자세한 내용은 알고리즘 섹션을 참조하십시오.

예: 'LeftKeys',1은 Tleft의 첫 번째 변수만 키 변수로 사용합니다.

RightKeys — Tright에서 키로 사용할 변수

양의 정수 | 양의 정수로 구성된 벡터 | string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | pattern형 스칼라 | 논리형 벡터

Tright에서 키로 사용할 변수로, 'RightKeys'와 함께 양의 정수, 양의 정수로 구성된 벡터, string형 배열, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, pattern형 스칼라 또는 논리형 벡터가 쉼표로 구분되어 지정됩니다.

'RightKeys' 이름-값 쌍의 인수는 'LeftKeys' 이름-값 쌍의 인수와 함께 사용해야 합니다. 'LeftKeys'와 'RightKeys'는 모두 동일한 수의 키 변수를 지정해야 합니다. outerjoin은 키 값의 순서에 기초하여 키 값의 쌍을 지정합니다.

행 레이블로 구성된 벡터는 키가 될 수 있습니다. 자세한 내용은 알고리즘 섹션을 참조하십시오.

예: 'RightKeys',3은 Tright의 세 번째 변수만 키 변수로 사용합니다.

MergeKeys — 키 병합 플래그

false (디폴트 값) | true | 0 | 1

키 병합 플래그로, 'MergeKeys'와 함께 false, true, 0, 1 중 하나가 쉼표로 구분되어 지정됩니다.

false

outerjoin은 테이블 Tleft와 테이블 Tright의 각 키 변수 쌍에 대해, 두 개의 개별 변수를 출력 테이블 T에 포함합니다. 이 동작은 디폴트 동작입니다.

true

outerjoin은 테이블 Tleft와 테이블 Tright의 각 키 변수 쌍에 대해, 단일 변수를 출력 테이블 T에 포함합니다. outerjoin은 Tleft의 키 값과 Tright의 키 값을 병합해 단일 변수를 만들어, 대응하는 행이 Tleft에 존재하면 Tleft에서 값을 가져오고 B에 존재하면 Tright에서 값을 가져옵니다. 키 변수 쌍의 키를 한 개만 포함하도록 'LeftVariables' 또는 'RightVariables'를 지정하면, outerjoin은 두 키 변수의 값을 모두 포함하는 병합된 키를 출력 테이블에 포함합니다. 키 변수 쌍의 두 키를 모두 제외하도록 'LeftVariables'와 'RightVariables'를 지정하면, outerjoin은 병합된 키 변수를 출력 테이블에 포함하지 않습니다.

LeftVariables — T에 포함시킬 Tleft의 변수

양의 정수 | 양의 정수로 구성된 벡터 | string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | pattern형 스칼라 | 논리형 벡터

T에 포함시킬 Tleft의 변수로, 'LeftVariables'와 함께 양의 정수, 양의 정수로 구성된 벡터, string형 배열, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, pattern형 스칼라 또는 논리형 벡터가 쉼표로 구분되어 지정됩니다.

'LeftVariables'를 사용하여 키 변수뿐 아니라 키가 아닌 변수를 출력 인수 T에 포함시키거나 제외할 수 있습니다.

기본적으로 outerjoin은 Tleft의 모든 변수를 포함합니다.

RightVariables — T에 포함시킬 Tright의 변수

양의 정수 | 양의 정수로 구성된 벡터 | string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | pattern형 스칼라 | 논리형 벡터

T에 포함시킬 Tright의 변수로, 'RightVariables'와 함께 양의 정수, 양의 정수로 구성된 벡터, string형 배열, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, pattern형 스칼라 또는 논리형 벡터가 쉼표로 구분되어 지정됩니다.

'RightVariables'를 사용하여 키 변수뿐 아니라 키가 아닌 변수를 출력 인수 T에 포함시키거나 제외할 수 있습니다.

기본적으로 outerjoin은 Tright의 모든 변수를 포함합니다.

Type — 외부 조인 연산의 유형

'full' (디폴트 값) | 'left' | 'right'

외부 조인 연산의 유형으로, 'Type'과 함께 'full'(완전 외부 조인을 의미함), 'left'(왼쪽 외부 조인) 또는 'right'(오른쪽 외부 조인)가 쉼표로 구분되어 지정됩니다.

• 입력값 Tleft와 Tright의 완전 외부 조인의 경우 출력값 T는 양쪽 입력값의 모든 행을 결합하고 빈 테이블 요소를 누락값으로 채웁니다.

  

• 왼쪽 외부 조인의 경우 출력값 T는 Tleft의 모든 행을 포함하지만 키 값이 Tleft의 어떤 키 값과도 일치하지 않는 Tright의 행은 제외합니다.

  

• 오른쪽 외부 조인의 경우 T는 Tright의 모든 행을 포함하지만 키 값이 Tright의 어떤 키 값과도 일치하지 않는 Tleft의 행은 제외합니다.

  

기본적으로, outerjoin은 완전 외부 조인을 수행하고 Tleft와 Tright 모두의 일치하지 않는 행을 포함합니다.

출력 인수

T — Tleft와 Tright의 외부 조인

테이블

Tleft와 Tright의 외부 조인으로, 테이블로 반환됩니다. 테이블 Tleft와 테이블 Tright에서 동일한 키 값 조합을 공유하는 행의 쌍마다 한 행씩 출력 테이블 T에 포함됩니다. Tleft와 Tright가 동일한 이름을 가진 변수를 포함할 경우, outerjoin은 T에서 대응하는 변수 이름에 고유한 접미사를 추가합니다. T의 변수 중 Tleft에서 온 변수는 Tright와 일치하는 항목이 없는 행에 누락값을 포함합니다. 마찬가지로, T의 변수 중 Tright에서 온 변수는 Tleft와 일치하는 항목이 없는 행에 누락값을 포함합니다.

(누락값은 NaN, NaT, 빈 string형 또는 정의되지 않은 categorical형 값과 같은, 다양한 데이터형에서의 "Not-a-Number"와 같습니다.)

일반적으로, 키 변수에 동일한 값 조합을 포함하는 행이 테이블 Tleft에 m개 있고 테이블 Tright에 n개가 있는 경우, 테이블 T에는 해당 조합에 대해 m*n개 행이 포함됩니다. 또한, 한 입력 테이블에 다른 입력 테이블의 어떤 행과도 일치하지 않는 키 값 조합이 있는 경우 그에 해당하는 행도 T에 포함됩니다.

T는 키 변수 값으로 정렬된 Tleft(ileft,LeftVars)와 Tright(iright,RightVars)의 가로 결합(Concatenate)을 포함합니다. 기본적으로 LeftVars는 Tleft의 모든 변수로, RightVars는 Tright의 모든 변수로 구성됩니다. 그렇지 않은 경우 LeftVars는 'LeftVariables' 이름-값 쌍의 인수로 지정된 변수로 구성되며, RightVars는 'RightVariables' 이름-값 쌍의 인수로 지정된 변수로 구성됩니다.

설명, 변수 단위, 변수 이름, 행 이름과 같은 메타데이터를 추가로 테이블에 저장할 수 있습니다. 자세한 내용은 table의 속성 섹션을 참조하십시오.

ileft — Tleft에 대한 인덱스

열 벡터

Tleft에 대한 인덱스로, 열 벡터로 반환됩니다. ileft의 각 요소는 출력 테이블 T의 행에 대응하는 테이블 Tleft의 행을 식별합니다. 벡터 ileft에 포함된 0은 Tleft의 행에 대응하지 않는 T의 행을 나타냅니다.

iright — Tright에 대한 인덱스

열 벡터

Tright에 대한 인덱스로, 열 벡터로 반환됩니다. iright의 각 요소는 출력 테이블 T의 행에 대응하는 테이블 Tright의 행을 식별합니다. 벡터 iright에 포함된 0은 Tright의 행에 대응하지 않는 T의 행을 나타냅니다.

세부 정보

키 변수

입력 테이블 Tleft와 Tright 간의 데이터를 일치시키고 결합하는 데 사용되는 변수입니다.

알고리즘

• 입력 테이블 또는 타임테이블의 행 레이블로 구성된 벡터를 키 변수로 사용할 수 있습니다. 행 레이블은 테이블의 행 이름 또는 타임테이블의 행 시간값입니다. 이 벡터를 키로 사용하려면 벡터를 'Row'(테이블의 행 이름에 대해), 행 시간값으로 구성된 타임테이블 벡터의 이름 또는 T.Properties.DimensionNames{1}의 값으로 지정하십시오. 여기서 T는 테이블 또는 타임테이블입니다.

  일반적으로, outerjoin은 입력 테이블 Tleft에서 출력 테이블 T로 행 레이블을 복사합니다.

  • Tleft에 행 레이블이 없으면 T에도 행 레이블이 없습니다.

  • Tleft에 행 레이블이 있으면 outerjoin은 Tleft에서 행 레이블을 복사하여 T에 행 레이블을 만듭니다.

    • Tleft와 Tright 모두의 행 레이블을 키 쌍으로 지정하면 outerjoin은 필요한 경우 Tright의 행 레이블을 T의 행 레이블에 병합합니다.

    • Tleft의 행 레이블을 키로 지정하되 Tright의 행 레이블을 일치하는 키로 지정하지 않으면, outerjoin은 필요한 경우 T에 디폴트 행 레이블을 생성합니다. 일반적으로 디폴트 행 레이블은 NaN 또는 누락값입니다.

    • Tleft와 Tright가 테이블인데 어떠한 입력값의 행 이름도 키로 지정하지 않으면 outerjoin은 T에 행 이름을 만들지 않습니다.

    • Tleft와 Tright가 타임테이블인데 어떠한 입력값의 행 시간값도 키로 지정하지 않으면 outerjoin은 Tleft의 행 시간값을 T에 복사합니다. 또한 필요한 경우 행 시간값을 NaN 또는 NaT로 채웁니다.

  Tleft의 행 레이블을 왼쪽 테이블의 키로 사용하고 Tright의 변수를 오른쪽 테이블의 키로 사용하여 외부 조인을 수행할 수는 없습니다. 외부 조인을 수행하려면 Tleft의 행 레이블을 테이블 변수로 변환하고 새 테이블 변수를 키로 사용하십시오.

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

outerjoin 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 입력 테이블에서는 'MergeKeys' 값이 true(논리값 1)인 경우를 제외하고 키 변수들의 이름이 같아서는 안 됩니다.

• 일반적으로 입력 테이블에서는 키에 해당하지 않는 변수들의 이름이 같아서는 안 됩니다. 그러나 'LeftVariables' 및 'RightVariables' 이름-값 인수를 지정하는 경우 입력 테이블의 서브셋을 조인할 수 있습니다. 이러한 인수를 지정하여 변수 이름이 'LeftVariables'와 'RightVariables' 둘 다에 나타나지 않도록 하십시오.

• 아래와 같은 이름-값 인수의 값은 상수여야 합니다.

  • 'Keys'

  • 'LeftKeys'

  • 'RightKeys'

  • 'MergeKeys'

  • 'LeftVariables'

  • 'RightVariables'

  • 'Type'

• 아래와 같은 이름-값 인수의 값은 패턴 표현식을 지원하지 않습니다.

  • 'Keys'

  • 'LeftKeys'

  • 'RightKeys'

  • 'LeftVariables'

  • 'RightVariables'

• 중첩 테이블과 타임테이블은 지원되지 않습니다.

스레드 기반 환경
MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

버전 내역

R2013b에 개발됨

참고 항목

함수

• join | innerjoin

라이브 편집기 작업

• 테이블 조인